[Clfs-commits] [Cross-LFS]Cross-LFS Book branch, master, updated. clfs-2.1.0-1286-g63f1942

git git at cross-lfs.org
Mon Jun 23 20:42:10 PDT 2014


This is an automated email from the git hooks/post-receive script. It was
generated because a ref change was pushed to the repository containing
the project "Cross-LFS Book".

The branch, master has been updated
       via  63f19424c04637b783c6f6e0f1f7787df953dc4a (commit)
      from  f99afd3b8ac0b90e769b7432f6cee52b742ceb99 (commit)

Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.

- Log -----------------------------------------------------------------
commit 63f19424c04637b783c6f6e0f1f7787df953dc4a
Author: Chris Staub <chris at beaker67.com>
Date:   Mon Jun 23 23:42:03 2014 -0400

    Added text about timesyncd

diff --git a/BOOK/introduction/common/changelog.xml b/BOOK/introduction/common/changelog.xml
index 3d678af..ef80cd7 100644
--- a/BOOK/introduction/common/changelog.xml
+++ b/BOOK/introduction/common/changelog.xml
@@ -37,6 +37,17 @@
 -->
 
     <listitem>
+      <para>23 June 2014</para>
+      <itemizedlist>
+        <listitem>
+          <para>[Chris] - Added info about systemd-timesyncd to network
+          configuration section. Fixes ticket
+          <ulink url="http://trac.cross-lfs.org/ticket/958">#958</ulink>.</para>
+        </listitem>
+      </itemizedlist>
+    </listitem>
+
+    <listitem>
       <para>20 June 2014</para>
       <itemizedlist>
         <listitem>
diff --git a/BOOK/network/common/systemd-network.xml b/BOOK/network/common/systemd-network.xml
index 9fdc924..f529ee7 100644
--- a/BOOK/network/common/systemd-network.xml
+++ b/BOOK/network/common/systemd-network.xml
@@ -10,20 +10,28 @@
 
   <title>Networking Configuration with Systemd-networkd</title>
 
-  <sect2 role="static">
-    <title>Creating the Static Network Interface Configuration Files</title>
+  <sect2 role="interface-config">
+    <title>Network Interface Configuration</title>
 
     <note><para>Udev may assign random Network Card Interface names
     for some network cards such as enp2s1. If you are not sure what
     your Network Card Interface name is, you can always run
-    <command>ip l</command> after you have booted your system. It is important that the <envar>Name</envar> variable in  <filename>/etc/systemd/network</filename> contain the correct Network Card Interface name (e.g.
-    <envar>Name=enp2s1</envar> or
+    <command>ip l</command> after you have booted your system. It is important
+    that the <envar>Name</envar> variable in
+    <filename>/etc/systemd/network</filename> contain the correct Network Card
+    Interface name (e.g. <envar>Name=enp2s1</envar> or
     <envar>Name=eth0</envar>) or systemd will fail to bring
     up your network interface.</para></note>
 
-    <para><command>systemd-networkd</command> uses <filename>/etc/system/network</filename> for configuration files. Refer to systemd.network(5) and systemd.netdev(5). Configure a network interface with a config file. Adjust Name= as required:</para>
+    <sect3 role="static">
+      <title>Static Network Interface Configuration</title>
 
-<screen><userinput>cd /etc/systemd/network &&
+      <para><command>systemd-networkd</command> uses
+      <filename>/etc/system/network</filename> for configuration files. Refer
+      to systemd.network(5) and systemd.netdev(5). Configure a network
+      interface with a config file. Adjust Name= as required:</para>
+
+  <screen><userinput>cd /etc/systemd/network &&
 cat > static.network << "EOF"
 [Match]
 Name=enp2s0
@@ -33,25 +41,29 @@ Address=192.168.1.1/24
 Gateway=192.168.1.2
 EOF</userinput></screen>
 
-    <para os="var-ob">The values of these variables must be changed in every
-    file to match the proper setup.</para>
+      <para os="var-ob">The values of these variables must be changed in every
+      file to match the proper setup.</para>
 
-    <para os="var-i">The <envar>Name</envar> variable defines the interface
-    name, for example, eth0. It is required for all network device configuration
-    files.</para>
+      <para os="var-i">The <envar>Name</envar> variable defines the interface
+      name, for example, eth0. It is required for all network device
+      configuration files.</para>
 
-    <para>The <envar>Gateway</envar> variable should contain the default
-    gateway IP address, if one is present. If not, then comment out the
-    variable entirely.</para>
+      <para>The <envar>Gateway</envar> variable should contain the default
+      gateway IP address, if one is present. If not, then comment out the
+      variable entirely.</para>
 
-    <para>For more information see the <command>systemd.netdev</command> man page.</para>
+      <para>For more information see the <command>systemd.netdev</command> man page.</para>
 
-  </sect2>
+    </sect3>
 
-  <sect2 role="dhcp">
-    <title>Connecting to a network with DHCP</title>
+    <sect3 role="dhcp">
+      <title>Connecting to a network with DHCP</title>
 
-  <para><command>systemd-networkd</command> uses <filename>/etc/systemd/network</filename> for configuration files. Refer to <filename>systemd.network(5)</filename> and <filename>systemd.netdev(5)</filename>. Configure a network interface with a config file. Adjust Name= as required:</para>
+    <para><command>systemd-networkd</command> uses
+    <filename>/etc/systemd/network</filename> for configuration files. Refer
+    to <filename>systemd.network(5)</filename> and
+    <filename>systemd.netdev(5)</filename>. Configure a network interface
+    with a config file. Adjust Name= as required:</para>
 
 <screen><userinput>cd /etc/systemd/network &&
 cat > dhcp.network << "EOF"
@@ -62,10 +74,36 @@ Name=enp2s0
 DHCP=yes
 EOF</userinput></screen>
 
-  <para><command>systemd-networkd</command> will automatically configure <filename>/run/systemd/network/resolv.conf</filename> when using DHCP. If you did not manually create <filename>/etc/resolv.conf</filename>, create a symlink:</para>
+    <para><command>systemd-networkd</command> will automatically configure
+    <filename>/run/systemd/network/resolv.conf</filename> when using DHCP.
+    If you did not manually create <filename>/etc/resolv.conf</filename>,
+    create a symlink:</para>
 
 <screen><userinput>ln -sv /run/systemd/network/resolv.conf /etc</userinput></screen>
 
+    </sect3>
+
+  </sect2>
+
+  <sect2 role="timesyncd">
+    <title>Using Timesyncd</title>
+
+    <para>Systemd includes a simple NTP client daemon,
+    <command>systemd-timesyncd</command>, though it is disabled by
+    default. If you want to enable it, you will first need to add a required
+    user and group:</para>
+
+<screen><userinput>groupadd -g &gid-systemd-timesync; systemd-timesync
+useradd -g systemd-timesync -u &uid-systemd-timesync; -d /dev/null -s /bin/false systemd-timesync</userinput></screen>
+
+    <para>Then, actually enable <command>systemd-timesyncd</command> so that
+    it will run on system boot:</para>
+
+<screen><userinput>systemctl enable systemd-timesyncd</userinput></screen>
+
+    <para>You can configure <command>systemd-timesyncd</command> by editing
+    <filename>/etc/systemd/timesyncd.conf</filename>.</para>
+
   <para>Continue to <xref linkend="chapter-bootable"/>.</para>
 
   </sect2>
diff --git a/BOOK/users_groups.ent b/BOOK/users_groups.ent
index 6c42bbc..c1aaa2d 100644
--- a/BOOK/users_groups.ent
+++ b/BOOK/users_groups.ent
@@ -10,6 +10,7 @@
 <!ENTITY uid-messagebus "27">
 <!ENTITY uid-mail "30">
 <!ENTITY uid-news "31">
+<!ENTITY uid-systemd-timesync "41">
 <!ENTITY uid-operator "50">
 <!ENTITY uid-postmaster "51">
 <!ENTITY uid-nobody "65534">
@@ -40,5 +41,6 @@
 <!ENTITY gid-mail "30">
 <!ENTITY gid-news "31">
 <!ENTITY gid-wheel "39">
+<!ENTITY gid-systemd-timesync "41">
 <!ENTITY gid-users "1000">
 <!ENTITY gid-nogroup "65533">

-----------------------------------------------------------------------

Summary of changes:
 BOOK/introduction/common/changelog.xml  |   11 ++++
 BOOK/network/common/systemd-network.xml |   78 +++++++++++++++++++++++--------
 BOOK/users_groups.ent                   |    2 +
 3 files changed, 71 insertions(+), 20 deletions(-)


hooks/post-receive
-- 
Cross-LFS Book



More information about the Clfs-commits mailing list