Changeset 0125883 for BOOK

Timestamp:

Jan 23, 2014, 10:09:00 PM (11 years ago)

Author:

William Harrington <kb0iic@…>

Branches:

clfs-3.0.0-systemd, clfs-3.0.0-sysvinit, master, systemd, sysvinit

Children:

3a85bbd

Parents:

15f0ac6

Message:

Rewrite dhcp.xml for systemd control utilizing the dhcpcd@service unit.

File:

• BOOK/network/common/dhcp.xml (modified) (2 diffs)

BOOK/network/common/dhcp.xml

@@ -9 +9 @@
   <?dbhtml filename="network-dhcp.html"?>
 
-  <title>DHCP Networking Configuration</title>
+  <title>DHCP Network Configuration</title>
 
   <sect2>
-    <title>Creating the DHCP Network Interface Configuration Files</title>
+    <title>Creating the DHCP Network Interface Configuration File</title>
 
-    <para>The following is an example for the eth0 interface. Create the
-    <filename>/etc/sysconfig/ifconfig.eth0</filename>
-    configuration file using the following commands. Adjust appropriately for
-    additional interfaces:</para>
+    <para>The following is an example for the eth0 interface. Refer to the
+    dhcpcd.conf man page for more information. This step may be skipped if
+    default behavior of dhcpcd is required.</para>
 
-<screen><userinput>mkdir -pv /etc/sysconfig &amp;&amp;
-cd /etc/sysconfig &amp;&amp;
-cat &gt; ifconfig.eth0 &lt;&lt; "EOF"
-<literal>SERVICE="dhcpcd"
+    <para>Create the <filename>/etc/dhcpcd.conf</filename> configuration file
+    using the following commands. Adjust appropriately for additional options:</para>
 
-# Start Command for DHCPCD
-DHCP_START="-q"
+<screen><userinput>cd /etc &amp;&amp;
+cat &gt; dhcpcd.conf &lt;&lt; "EOF"
+<literal># dhcpcd configuration eth0 interface
+# See dhcpcd.conf(5) for details.
 
-# Stop Command for DHCPCD
-DHCP_STOP="-k"</literal>
+interface eth0
+# dhcpcd-run-hooks uses these options.
+option subnet_mask, routers, domain_name_servers
+
+# The default timeout for waiting for a DHCP response is 30 seconds
+# which may be too long or too short and can be changed here.
+timeout 16</literal>
 EOF</userinput></screen>
-
-    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
-    href="static.xml"
-    xpointer="xpointer(//*[@os='var-ob'])"/>
-
-    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
-    href="static.xml"
-    xpointer="xpointer(//*[@os='var-s'])"/>
-
-    <para>The <envar>DHCP_START</envar> and <envar>DHCP_STOP</envar> variables
-    arguments that are passed onto <filename>dhcpcd</filename> when starting
-    and stoppping the service. More information about what can be passed can
-    be found in the <filename>dhcpcd(8)</filename> man page.</para>
 
     <para>To configure another Static Interface, Follow <xref linkend="ch-network-static"/>.</para>
@@ -48 +39 @@
   </sect2>
 
+  <sect2>
+    <title>Configuring the Network Interface at boot</title>
+
+    <para>Enabling of the Network Interface configuration is
+    done per interface. To enable Network Interface
+    configuration at boot, run:</para>
+
+<screen role="nodump"><userinput>systemctl enable dhcpcd@eth0</userinput></screen>
+
+    <para>To disable previously enabled Network Interface
+    configuration at boot, run:</para>
+
+<screen role="nodump"><userinput>systemctl disable dhcpcd@eth0</userinput></screen>
+
+    <para>To manually start the Network Interface configuration,
+    run:</para>
+
+<screen role="nodump"><userinput>systemctl start dhcpcd@eth0</userinput></screen>
+
+    <para>Replace eth0 with the correct Network Interface
+    name as described on the beginning of this page.</para>
+
+  </sect2>
+
 </sect1>