cvs commit: BLFS/BOOK/introduction/welcome changelog.xml

markh at linuxfromscratch.org markh at linuxfromscratch.org
Fri Oct 4 17:05:31 PDT 2002


markh       02/10/04 17:05:31

  Modified:    BOOK/connect connect.ent
               BOOK/connect/dhcp dhcp-client.xml dhcp.xml
               BOOK/connect/dhcp/dhcpcd dhcpcd-config.xml
               BOOK/introduction/welcome changelog.xml
  Added:       BOOK/connect/dhcp bootscripts.xml
  Removed:     BOOK/connect/dhcp config.xml
  Log:
  clarify dhcp client instructions
  
  Revision  Changes    Path
  1.2       +1 -1      BLFS/BOOK/connect/connect.ent
  
  Index: connect.ent
  ===================================================================
  RCS file: /home/cvsroot/BLFS/BOOK/connect/connect.ent,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- connect.ent	7 Jul 2002 20:28:46 -0000	1.1
  +++ connect.ent	5 Oct 2002 00:05:31 -0000	1.2
  @@ -12,7 +12,7 @@
   <!ENTITY connect-dhcp-client SYSTEM "dhcp/dhcp-client.xml">
   <!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 -->
   <!ENTITY connect-other SYSTEM "other/other.xml">
  
  
  
  1.4       +31 -17    BLFS/BOOK/connect/dhcp/dhcp-client.xml
  
  Index: dhcp-client.xml
  ===================================================================
  RCS file: /home/cvsroot/BLFS/BOOK/connect/dhcp/dhcp-client.xml,v
  retrieving revision 1.3
  retrieving revision 1.4
  diff -u -r1.3 -r1.4
  --- dhcp-client.xml	4 Aug 2002 19:08:12 -0000	1.3
  +++ dhcp-client.xml	5 Oct 2002 00:05:31 -0000	1.4
  @@ -2,26 +2,40 @@
   <?dbhtml filename="dhcpclient.html" dir="connect"?>
   <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 &&
  +cat > ifconfig.eth0 << "EOF"</userinput>
  +ONBOOT=yes
  +DHCP_PROG=/sbin/dhclient
  +DHCP_START=<appropriate start parameters>
  +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 > /etc/dhclient.conf << "EOF"</userinput>
   # dhclient.conf
  
  
  
  1.2       +6 -4      BLFS/BOOK/connect/dhcp/dhcp.xml
  
  Index: dhcp.xml
  ===================================================================
  RCS file: /home/cvsroot/BLFS/BOOK/connect/dhcp/dhcp.xml,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- dhcp.xml	7 Jul 2002 20:28:47 -0000	1.1
  +++ dhcp.xml	5 Oct 2002 00:05:31 -0000	1.2
  @@ -10,12 +10,14 @@
   modems.</para>
   
   <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>
  
  
  
  1.1                  BLFS/BOOK/connect/dhcp/bootscripts.xml
  
  Index: bootscripts.xml
  ===================================================================
  <sect1 id="dhcpclient" xreflabel="Configuring the LFS bootscripts to support DHCP clients">
  <?dbhtml filename="configdhcp.html" dir="connect"?>
  <title>Configuring the LFS bootscripts to support DHCP clients</title>
  
  <sect2><title>Config files</title>
  <para><userinput>/etc/sysconfig/network, 
  /etc/sysconfig/network-devices/ifup-eth0,
  /etc/sysconfig/network-devices/ifdown-eth0,
  /etc/sysconfig/networkdevices/ifconfig.eth0</userinput></para>
  </sect2>
  
  <sect2><title>Configuration Information</title>
  
  <para>Note that on this and the following pages, we 
  use <userinput>eth0</userinput> as the example interface.
  If you want to configure a different (or more than one) interface, simply 
  replace <userinput>eth0</userinput> with the interface you wish to use.</para>
  
  <para>These instructions will convert the configuration files from LFS
  (a static configuration) to a configuration using the DHCP protocol.  
  Note that static and DHCP-based interfaces can co-exist on a LFS system.  To
  do this, you should only make the alterations to those interfaces which 
  need to support DHCP.  All of the instructions on this page are applicable
  no matter which DHCP client you intend to use.</para>
  
  <para>If the interface you intend to use as your default gateway is going to 
  use DHCP, the first step is to remove the GATEWAY and GATEWAY_IF variables 
  from <filename>/etc/sysconfig/network</filename>.  This will only need to be
  done once.</para>
  
  <para><screen><userinput>cd /etc/sysconfig &&
  cp network network.bak &&
  sed "s/GATEWAY/# GATEWAY/" network.bak > network</userinput></screen></para>
  
  <para>You then need to create scripts which will override the default
  network scripts and provide DHCP support.  These two scripts are generic and
  so for use with both DHCP clients.  First, the
  <filename>ifup-eth0</filename> script:</para>
  
  <para><screen><userinput>cat > ifup-eth0 << "EOF" </userinput>
  #!/bin/sh
  
  source /etc/sysconfig/rc || exit
  source $rc_functions || exit
  source $network_devices/ifconfig.eth0 || exit
  
  echo "Bringing up the eth0 interface..."
  modprobe eth0
  loadproc $DHCP_PROG $DHCP_START
  <userinput>EOF</userinput></screen></para>
  
  <para>Then the <filename>ifdown-eth0</filename> script:</para>
  
  <para><screen><userinput>cat > ifdown-eth0 << "EOF" </userinput>
  #!/bin/sh
  
  source /etc/sysconfig/rc || exit
  source $rc_functions || exit
  source $network_devices/ifconfig.eth0 || exit
  
  echo "Bringing down the eth0 interface..."
  $DHCP_PROG $DHCP_STOP
  evaluate_retval
  <userinput>EOF</userinput></screen></para>
  
  <para>Finally, we need to make these scripts executable:</para>
  
  <para><screen><userinput>chmod 755 ifup-eth0 &&
  chmod 755 ifdown-eth0</userinput></screen></para>
  
  </sect2>
  
  </sect1>
  
  
  
  
  1.5       +15 -6     BLFS/BOOK/connect/dhcp/dhcpcd/dhcpcd-config.xml
  
  Index: dhcpcd-config.xml
  ===================================================================
  RCS file: /home/cvsroot/BLFS/BOOK/connect/dhcp/dhcpcd/dhcpcd-config.xml,v
  retrieving revision 1.4
  retrieving revision 1.5
  diff -u -r1.4 -r1.5
  --- dhcpcd-config.xml	18 Aug 2002 02:38:12 -0000	1.4
  +++ dhcpcd-config.xml	5 Oct 2002 00:05:31 -0000	1.5
  @@ -6,12 +6,21 @@
   
   <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 &&
  +cat > ifconfig.eth0 << "EOF"</userinput>
  +ONBOOT=yes
  +DHCP_PROG=/sbin/dhcpcd
  +DHCP_START=<appropriate start parameters>
  +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>
   
  
  
  
  1.183     +3 -0      BLFS/BOOK/introduction/welcome/changelog.xml
  
  Index: changelog.xml
  ===================================================================
  RCS file: /home/cvsroot/BLFS/BOOK/introduction/welcome/changelog.xml,v
  retrieving revision 1.182
  retrieving revision 1.183
  diff -u -r1.182 -r1.183
  --- changelog.xml	4 Oct 2002 19:25:58 -0000	1.182
  +++ changelog.xml	5 Oct 2002 00:05:31 -0000	1.183
  @@ -10,6 +10,9 @@
   
   <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"
   to mozilla (from Tushar).</para></listitem>
   
  
  
  
-- 
Unsubscribe: send email to listar at linuxfromscratch.org
and put 'unsubscribe blfs-book' in the subject header of the message



More information about the blfs-book mailing list