Changeset 138bdf6

Timestamp:

06/09/2016 05:34:10 AM (7 years ago)

Author:

DJ Lucas <dj@…>

Branches:

10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 7.10, 8.0, 8.1, 8.2, 8.3, 8.4, 9.0, 9.1, basic, bdubbs/svn, elogind, ken/inkscape-core-mods, lazarus, nosym, perl-modules, plabs/python-mods, qt5new, trunk, upgradedb, xry111/intltool, xry111/soup3, xry111/test-20220226

Children:

2bbb3379

Parents:

0098ace6

Message:

[Systemd merge] - Chapter 14

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@17469 af4574ff-66df-0310-9fd7-8a98e5e911e0

Location:

networking/connect

Files:

• dhcp.xml (modified) (12 diffs)
• dhcpcd.xml (modified) (1 diff)

networking/connect/dhcp.xml

@@ -31 +31 @@
 
     <para>
-      The <application>ISC DHCP</application> package contains both the client and
-      server programs for DHCP. <command>dhclient</command> (the client) is
+      The <application>ISC DHCP</application> package contains both the client
+      and server programs for DHCP. <command>dhclient</command> (the client) is
       used for connecting to a network which uses DHCP to assign network
       addresses. <command>dhcpd</command> (the server) is used for assigning
@@ -186 +186 @@
 
     <para>
-      Skip to <xref linkend="dhclient-config" revision="sysv"/>
-      <xref linkend="dhclient-config-systemd" revision="systemd"/>
-      in order to configure the client
+      Skip to <xref linkend="dhclient-config"/> in order to configure the
+      client
     </para>
 
@@ -237 +236 @@
     </sect3>
 
-    <sect3 id="dhclient-config" revision="sysv">
+    <sect3 id="dhclient-config">
       <title>Client Configuration</title>
 
@@ -278 +277 @@
 <screen role="root"><userinput>install -v -dm 755 /var/lib/dhclient</userinput></screen>
 
+      <para id="dhclient-service-sysd" revision="systemd">
+        If you want to configure network interfaces at boot using
+        <command>dhclient</command>, you need to install the
+        <filename>dhclient@.service</filename> unit included in the
+        <xref linkend="systemd-units"/> package by running the following
+        command as the <systemitem class="username">root</systemitem> user:
+      </para>
+
+      <indexterm zone="dhcp dhclient-service-sysd" revision="systemd">
+        <primary sortas="f-dhclient">dhclient@.service</primary>
+      </indexterm>
+
+<screen role="root" revision="systemd"><userinput>make install-dhclient</userinput></screen> 
+
+      <note revision="systemd">
+        <para>
+          Make sure that you disable the <command>systemd-networkd</command>
+          service or configure it not to manage the interfaces you want to
+          manage with <command>dhclient</command>.
+        </para>
+      </note>
+
       <para>
         At this point you can test if <command>dhclient</command> is
@@ -284 +305 @@
       </para>
 
-<screen role="root"><userinput>dhclient <replaceable>&lt;eth0&gt;</replaceable></userinput></screen>
-
-      <para>
+<screen role="root" revision="sysv"><userinput>dhclient <replaceable>&lt;eth0&gt;</replaceable></userinput></screen>
+
+<screen role="root" revision="systemd"><userinput>systemctl start dhclient@<replaceable>eth0</replaceable></userinput></screen>
+
+      <para revision="sysv">
         Replace <replaceable>&lt;eth0&gt;</replaceable> with your
         desired interface. If you want more verbose output, add the
@@ -292 +315 @@
       </para>
 
-      <para id="dhclient-service">
+      <para id="dhclient-service" revision="sysv">
         If you want to configure network interfaces at boot using
         <command>dhclient</command>, you need to install the
@@ -299 +322 @@
       </para>
 
-<screen role="root"><userinput>make install-service-dhclient</userinput></screen>
-
-      <indexterm zone="dhcp dhclient-service">
+<screen role="root" revision="sysv"><userinput>make install-service-dhclient</userinput></screen>
+
+      <indexterm zone="dhcp dhclient-service" revision="sysv">
         <primary sortas="f-dhclient">dhclient (service script)</primary>
       </indexterm>
 
-      <para id="dhclient-ifconfig">
+      <para id="dhclient-ifconfig" revision="sysv">
         Next, create the <filename>/etc/sysconfig/ifconfig.eth0</filename>
         configuration file with the following commands as the
@@ -311 +334 @@
       </para>
 
-<screen role="root"><userinput>cat &gt; /etc/sysconfig/ifconfig.eth0 &lt;&lt; "EOF"
+<screen role="root" revision="sysv"><userinput>cat &gt; /etc/sysconfig/ifconfig.eth0 &lt;&lt; "EOF"
 <literal>ONBOOT="yes"
 IFACE="eth0"
@@ -327 +350 @@
 EOF</userinput></screen>
 
-      <indexterm zone="dhcp dhclient-ifconfig">
+      <indexterm zone="dhcp dhclient-ifconfig" revision="sysv">
         <primary sortas="e-etc-sysconfig-...-dhclient">/etc/sysconfig/ifconfig.eth0</primary>
       </indexterm>
 
-      <para>
+      <para revision="sysv">
         Adjust the file to suit your needs.
       </para>
 
-      <para>
+      <para revision="sysv">
         For more information on the appropriate <envar>DHCP_START</envar>
         and <envar>DHCP_STOP</envar> values see
@@ -341 +364 @@
       </para>
 
-    </sect3>
-
-    <sect3 id="dhclient-config-systemd" revision="systemd">
-      <title>Client Configuration</title>
-
-      <para>TBA</para>
+      <para revision="systemd">
+        To start <command>dhclient</command> on a specific interface
+        at boot, enable the previously installed systemd unit by
+        running the following command as the
+        <systemitem class="username">root</systemitem> user:
+      </para>
+
+<screen role="root" revision="systemd"><userinput>systemctl enable dhclient@<replaceable>eth0</replaceable></userinput></screen>
+
+      <para revision="systemd">
+        Replace <replaceable>eth0</replaceable> with the actual interface name.
+      </para>
+
     </sect3>
 
@@ -402 +432 @@
 
        <para>
-        If you want to start the DHCP Server at boot, install
-        the <filename revision="sysv">/etc/rc.d/init.d/dhcpd</filename>
-        <filename revision="systemd">dhcpd.service</filename>
-        init script included in the
+        If you want to start the DHCP Server at boot, install the
+        <phrase revision="sysv"><filename>/etc/rc.d/init.d/dhcpd</filename>
+        inti script</phrase>
+        <phrase revision="systemd"><filename>dhcpd.service</filename>
+        unit</phrase> included in the
         <xref linkend="bootscripts" revision="sysv"/>
         <xref linkend="systemd-units" revision="systemd"/>
@@ -419 +450 @@
       <para>
         You will need to edit the
-        <filename>/etc/sysconfig/dhcpd</filename> in order
-        to set the interface on which <command>dhcpd</command>
+        <phrase revision="sysv"><filename>/etc/sysconfig/dhcpd</filename></phrase>
+        <phrase revision="systemd"><filename>/etc/default/dhcpd</filename></phrase>
+        in order to set the interface on which <command>dhcpd</command>
         will serve the DHCP requests.
       </para>

networking/connect/dhcpcd.xml

@@ -240 +240 @@
 nameserver 208.67.220.220</literal>
 EOF</userinput></screen>
+
+    </sect3>
+
+   <sect3 id="dhcpcd-init3" revision="systemd">
+      <title>General Configuration Information</title>
+
+      <para>
+        If you want to configure network interfaces at boot using
+        <command>dhcpcd</command>, you need to install the
+        systemd unit included in <xref linkend="systemd-units"/>
+        package by running the following command as the
+        <systemitem class="username">root</systemitem> user:
+      </para>
+
+<screen role="root"><userinput>make install-dhcpcd</userinput></screen>
+
+      <indexterm zone="dhcpcd dhcpcd-init3">
+        <primary sortas="f-dhcpcd">dhcpcd</primary>
+      </indexterm>
+
+      <para>
+        Whenever <command>dhcpcd</command> configures or shuts down
+        a network interface, it executes hook scripts. For more details
+        about those scripts, see the <command>dhcpcd-run-hooks</command> and
+        <command>dhcpcd</command> man pages.
+      </para>
+
+      <note>
+        <para id="dhcpcd-config5">The default behavior of
+        <command>dhcpcd</command> sets the hostname and mtu settings. It also
+        overwrites <filename>/etc/resolv.conf</filename> and
+        <filename>/etc/ntp.conf</filename>.
+
+        These modifications to system files and settings on system
+        configuration files are done by hooks which are stored in <filename
+        class="directory">/lib/dhcpcd/dhcpcd-hooks</filename>.
+
+        Setup <command>dhcpcd</command> by removing or adding hooks from/to
+        that directory.  The execution of hooks can be disabled by using the
+        <option>--nohook</option> (<option>-C</option>) command line option or
+        by the <option>nohook</option> option in the
+        <filename>/etc/dhcpcd.conf</filename> file.</para>
+      </note>
+
+      <indexterm zone="dhcpcd dhcpcd-config5">
+        <primary sortas="e-etc-resolv.conf">/etc/resolv.conf</primary>
+      </indexterm>
+
+    <note>
+      <para>
+        Make sure that you disable the <command>systemd-networkd</command>
+        service or configure it not to manage the interfaces you want to manage
+        with <application>dhcpcd</application>.
+      </para>
+    </note>
+
+      <para>
+        At this point you can test if <command>dhcpcd</command> is
+        behaving as expected by running the following command as the
+        <systemitem class="username">root</systemitem> user:
+      </para>
+
+<screen role="root"><userinput>systemctl start dhcpcd@<replaceable>eth0</replaceable></userinput></screen>
+
+      <para>
+        To start <command>dhcpcd</command> on a specific interface
+        at boot, enable the previously installed systemd unit by
+        running the following command as the
+        <systemitem class="username">root</systemitem> user:
+      </para>
+
+<screen role="root"><userinput>systemctl enable dhcpcd@<replaceable>eth0</replaceable></userinput></screen>
+
+      <para>
+        Replace <replaceable>eth0</replaceable> with the actual interface name.
+      </para>
 
     </sect3>