Changeset 050d775d

Timestamp:

10/05/2002 12:05:31 AM (22 years ago)

Author:

Mark Hymers <markh@…>

Branches:

10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 12.0, 12.1, 12.2, 6.0, 6.1, 6.2, 6.2.0, 6.2.0-rc1, 6.2.0-rc2, 6.3, 6.3-rc1, 6.3-rc2, 6.3-rc3, 7.10, 7.4, 7.5, 7.6, 7.6-blfs, 7.6-systemd, 7.7, 7.8, 7.9, 8.0, 8.1, 8.2, 8.3, 8.4, 9.0, 9.1, basic, bdubbs/svn, elogind, gimp3, gnome, kde5-13430, kde5-14269, kde5-14686, kea, ken/TL2024, ken/inkscape-core-mods, ken/tuningfonts, krejzi/svn, lazarus, lxqt, nosym, perl-modules, plabs/newcss, plabs/python-mods, python3.11, qt5new, rahul/power-profiles-daemon, renodr/vulkan-addition, systemd-11177, systemd-13485, trunk, upgradedb, v1_0, v5_0, v5_0-pre1, v5_1, v5_1-pre1, xry111/for-12.3, xry111/intltool, xry111/llvm18, xry111/soup3, xry111/spidermonkey128, xry111/test-20220226, xry111/xf86-video-removal

Children:

ee46bc8b

Parents:

d197ba76

Message:

clarify dhcp client instructions

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

Files:

• connect/connect.ent (modified) (1 diff)
• connect/dhcp/bootscripts.xml (added)
• connect/dhcp/config.xml (deleted)
• connect/dhcp/dhcp-client.xml (modified) (1 diff)
• connect/dhcp/dhcp.xml (modified) (1 diff)
• connect/dhcp/dhcpcd/dhcpcd-config.xml (modified) (1 diff)
• introduction/welcome/changelog.xml (modified) (1 diff)

connect/connect.ent

@@ -13 +13 @@
 <!ENTITY % dhcpcd SYSTEM "dhcp/dhcpcd/dhcpcd.ent">
 %dhcpcd;
-<!ENTITY connect-dhcp-config SYSTEM "dhcp/config.xml">
+<!ENTITY connect-dhcp-bootscripts SYSTEM "dhcp/bootscripts.xml">
 
 <!-- Other -->

connect/dhcp/dhcp-client.xml

@@ -3 +3 @@
 <title>dhcp-&dhcp-version;</title>
 
-<para>The dhcp package comes with both a client and a server program for
-using DHCP.  If you want to install it, the instructions can be found
-at <xref linkend="dhcp"/>.  Note that if you only want to
-use the client, you do <emphasis>not</emphasis> need to run the server and
-so do not need the startup script and links provided for the server daemon.
-Note that to use the client, you still need to alter your
-<filename>ethnet</filename> script as described in the next section.
-You only need to run the DHCP server however, if you're providing this
+<para>The dhcp package comes with both a client (called dhcpcd) and a 
+server program for using DHCP.  If you want to install this package, 
+the instructions can be found at <xref linkend="dhcp"/>.  
+Note that if you only want to use the client, you 
+do <emphasis>not</emphasis> need to run the server and so do not need 
+the startup script and links provided for the server daemon.
+You only need to run the DHCP server if you're providing this
 service to a network, and it's likely that you'll know if that's the
-case; if it isn't, don't run the server!</para>
+case; if it isn't, don't run the server!  Once you have installed the
+package, return here for information on how to configure the client
+(dhcpcd).</para>
 
-<para>To configure the client, you need to modify the
-<filename>/etc/sysconfig/network-devices/ifconfig.eth0</filename> file
-(or the appropriate one for the interface you are running DHCP on)
-you created earlier by adding the appropriate <userinput>DHCP_PROG
-</userinput>, <userinput>DHCP_START</userinput> and
-<userinput>DHCP_STOP</userinput> values.</para>
+<para>To configure dhclient, you need to create two files,
+<filename>/etc/sysconfig/network-devices/ifconfig.eth0</filename> and
+<filename>/etc/dhclient.conf</filename>.</para>
 
-<para>Then create the <filename>/etc/dhclient.conf</filename> using the
-following command:</para>
+<para>Firstly, create the <filename>ifconfig.eth0</filename>
+file with the following commands (note that this will overwrite any
+existing file):</para>
+
+<para><screen><userinput>cd /etc/sysconfig/network-devices &amp;&amp;
+cat &gt; ifconfig.eth0 &lt;&lt; "EOF"</userinput>
+ONBOOT=yes
+DHCP_PROG=/sbin/dhclient
+DHCP_START=&lt;appropriate start parameters&gt;
+DHCP_STOP=-r
+<userinput>EOF</userinput></screen></para>
+
+<para>For more information on the apppropriate 
+<userinput>DHCP_START</userinput> and <userinput>DHCP_STOP</userinput> 
+values, examine the man-page for dhclient.</para>
+
+<para>Secondly you should then create 
+the <filename>/etc/dhclient.conf</filename> using the following command:</para>
 
 <para><screen><userinput>cat &gt; /etc/dhclient.conf &lt;&lt; "EOF"</userinput>

connect/dhcp/dhcp.xml

@@ -11 +11 @@
 
 <para>We currently provide installation instructions for two DHCP
-clients, those from the dhcp and dhcpcd packages.  After we discuss
-installing the packages, we will also discuss how to
-configure your bootscripts to allow you to use dhcp as a client.</para>
+clients, dhclient (from the dhcp package) and dhcpcd.  We begin with a page
+which shows how to alter the LFS bootscripts for generic DHCP support.
+We then present the two sets of installation instructions which also discuss 
+how to create an appropriate configuration file to work with the 
+DHCP client of your choice.</para>
 
+&connect-dhcp-bootscripts;
 &connect-dhcp-client;
 &dhcpcd;
-&connect-dhcp-config;
 
 </chapter>

connect/dhcp/dhcpcd/dhcpcd-config.xml

@@ -7 +7 @@
 <sect3><title>Configuration Information</title>
 
-<para>To configure the client, you need to modify the
-<filename>/etc/sysconfig/network-devices/ifconfig.eth0</filename> file
-(or the appropriate one for the interface you are running DHCP on)
-you created earlier by adding the appropriate <userinput>DHCP_PROG
-</userinput>, <userinput>DHCP_START</userinput> and
-<userinput>DHCP_STOP</userinput> values.</para>
+<para>To configure dhcpcd, create the <filename>ifconfig.eth0</filename>
+file with the following commands (note that this will overwrite any
+existing file):</para>
+
+<para><screen><userinput>cd /etc/sysconfig/network-devices &amp;&amp;
+cat &gt; ifconfig.eth0 &lt;&lt; "EOF"</userinput>
+ONBOOT=yes
+DHCP_PROG=/sbin/dhcpcd
+DHCP_START=&lt;appropriate start parameters&gt;
+DHCP_STOP=-k
+<userinput>EOF</userinput></screen></para>
+
+<para>For more information on the apppropriate
+<userinput>DHCP_START</userinput> and <userinput>DHCP_STOP</userinput>
+values, examine the man-page for dhcpcd.</para>
 
 </sect3>

introduction/welcome/changelog.xml

@@ -10 +10 @@
 
 <itemizedlist>
+
+<listitem><para>October 4th, 2002 [markh]: Connect: Slight re-write of DHCP
+instructions to clarify them.</para></listitem>
 
 <listitem><para>October 4th, 2002 [markh]: Xsoft: Add dependency of "which"