Changeset 820d164a


Ignore:
Timestamp:
04/30/2005 06:18:55 PM (18 years ago)
Author:
Manuel Canales Esparcia <manuel@…>
Branches:
10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 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, gnome, kde5-13430, kde5-14269, kde5-14686, ken/inkscape-core-mods, krejzi/svn, lazarus, nosym, perl-modules, plabs/python-mods, qt5new, systemd-11177, systemd-13485, trunk, upgradedb, xry111/intltool, xry111/soup3, xry111/test-20220226
Children:
c99aa38
Parents:
0ee4762
Message:

Tagged dhcpcd.xml

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

File:
1 edited

Legend:

Unmodified
Added
Removed

  • connect/dhcp/dhcpcd.xml

    r0ee4762 r820d164a  
    1414
    1515<sect1 id="dhcpcd" xreflabel="dhcpcd-&dhcpcd-version;">
    16 <sect1info>
    17 <othername>$LastChangedBy$</othername>
    18 <date>$Date$</date>
    19 </sect1info>
    20 <?dbhtml filename="dhcpcd.html"?>
    21 <title>dhcpcd-&dhcpcd-version;</title>
    22 <indexterm zone="dhcpcd">
    23 <primary sortas="a-Dhcpcd">Dhcpcd</primary></indexterm>
    24 
    25 <sect2>
    26 <title>Introduction to <application>dhcpcd</application></title>
    27 
    28 <para>The <application>dhcpcd</application> package contains the
    29 <command>dhcpcd</command> client. This is useful for connecting your computer
    30 to a network which uses <acronym>DHCP</acronym> to assign network
    31 addresses.</para>
    32 
    33 <sect3><title>Package information</title>
    34 <itemizedlist spacing='compact'>
    35 <listitem><para>Download (HTTP): <ulink
    36 url="&dhcpcd-download-http;"/></para></listitem>
    37 <listitem><para>Download (FTP): <ulink
    38 url="&dhcpcd-download-ftp;"/></para></listitem>
    39 <listitem><para>Download MD5 sum: &dhcpcd-md5sum;</para></listitem>
    40 <listitem><para>Download size: &dhcpcd-size;</para></listitem>
    41 <listitem><para>Estimated disk space required:
    42 &dhcpcd-buildsize;</para></listitem>
    43 <listitem><para>Estimated build time:
    44 &dhcpcd-time;</para></listitem></itemizedlist>
    45 </sect3>
    46 
    47 <sect3><title>Additional downloads</title>
    48 <itemizedlist spacing='compact'>
    49 <listitem><para>Required Patch:
    50 <ulink url="&patch-root;/dhcpcd-&dhcpcd-version;-fhs-1.patch"/></para>
    51 </listitem>
    52 </itemizedlist>
    53 </sect3>
    54 
    55 </sect2>
    56 
    57 <sect2>
    58 <title>Installation of <application>dhcpcd</application></title>
    59 
    60 <para>Install <application>dhcpcd</application> by running the following
    61 commands:</para>
    62 
    63 <screen><userinput><command>patch -Np1 -i ../dhcpcd-&dhcpcd-version;-fhs-1.patch &amp;&amp;
     16  <?dbhtml filename="dhcpcd.html"?>
     17 
     18  <sect1info>
     19    <othername>$LastChangedBy$</othername>
     20    <date>$Date$</date>
     21  </sect1info>
     22 
     23  <title>Dhcpcd-&dhcpcd-version;</title>
     24 
     25  <indexterm zone="dhcpcd">
     26    <primary sortas="a-Dhcpcd">Dhcpcd</primary>
     27  </indexterm>
     28
     29  <sect2 role="package">
     30    <title>Introduction to Dhcpcd</title>
     31
     32    <para>The <application>dhcpcd</application> package contains the
     33    <command>dhcpcd</command> client. This is useful for connecting your computer
     34    to a network which uses DHCP to assign network addresses.</para>
     35   
     36    <bridgehead renderas="sect3">Package Information</bridgehead>
     37    <itemizedlist spacing="compact">
     38      <listitem>
     39        <para>Download (HTTP): <ulink url="&dhcpcd-download-http;"/></para>
     40      </listitem>
     41      <listitem>
     42        <para>Download (FTP): <ulink url="&dhcpcd-download-ftp;"/></para>
     43      </listitem>
     44      <listitem>
     45        <para>Download MD5 sum: &dhcpcd-md5sum;</para>
     46      </listitem>
     47      <listitem>
     48        <para>Download size: &dhcpcd-size;</para>
     49      </listitem>
     50      <listitem>
     51        <para>Estimated disk space required: &dhcpcd-buildsize;</para>
     52      </listitem>
     53      <listitem>
     54        <para>Estimated build time: &dhcpcd-time;</para>
     55      </listitem>
     56    </itemizedlist>
     57   
     58    <bridgehead renderas="sect3">Additional Downloads</bridgehead>
     59    <itemizedlist spacing='compact'>
     60      <listitem>
     61        <para>Required Patch:
     62        <ulink url="&patch-root;/dhcpcd-&dhcpcd-version;-fhs-1.patch"/></para>
     63      </listitem>
     64    </itemizedlist>
     65   
     66  </sect2>
     67 
     68  <sect2 role="installation">
     69    <title>Installation of Dhcpcd</title>
     70
     71    <para>Install <application>dhcpcd</application> by running the following
     72    commands:</para>
     73
     74<screen><userinput>patch -Np1 -i ../dhcpcd-&dhcpcd-version;-fhs-1.patch &amp;&amp;
    6475./configure --prefix="" --sysconfdir=/var/lib \
    65 --mandir=/usr/share/man &amp;&amp;
    66 make</command></userinput></screen>
    67 
    68 <para>Now, as the root user:</para>
    69 
    70 <screen><userinput role='root'><command>make install</command></userinput></screen>
    71 
    72 </sect2>
    73 
    74 <sect2>
    75 <title>Command explanations</title>
    76 
    77 <para><command>patch -Np1 -i ../dhcpcd-&dhcpcd-version;-fhs-1.patch</command>:
    78 <application>dhcpcd</application> unpatched puts all configuration
    79 and temporary files in <filename class='directory'>/etc/dhcpc</filename>. This
    80 becomes very annoying when <application>dhcpcd</application> tells you it's
    81 running and it's not. You look in
    82 <filename class="directory">/var/run</filename> for the
    83 <filename>PID</filename> file, but it's not there, the
    84 <filename>PID</filename> file that needs deleting is in
    85 <filename class="directory">/etc/dhcpc</filename>. This patch brings this
    86 program into <acronym>FHS</acronym> compliance, but more importantly, puts
    87 files where you expect them to be.</para>
    88 
    89 <para><parameter>--prefix=""</parameter>: There may be a good reason for
    90 abandoning the normal <acronym>BLFS</acronym> convention of using
    91 <parameter>--prefix=/usr</parameter> here.  If you are installing
    92 <acronym>DHCP</acronym>, it is likely that it is
    93 required during the boot process and
    94 <filename class="directory">/usr</filename> may be network mounted, in which
    95 case <command>dhcpcd</command> wouldn't be available due to being on the
    96 network! Therefore, depending on your situation, you may want it to be
    97 installed in <filename class="directory">/sbin</filename> or
    98 <filename class="directory">/usr/sbin</filename>. This command installs to
    99 <filename class="directory">/sbin</filename>.</para>
    100 
    101 <para><parameter>--sysconfdir=/var/lib</parameter>: This command installs
    102 configuration files in the <filename class="directory">/var/lib</filename>
    103 directory.</para>
    104 
    105 <para><parameter>--mandir=/usr/share/man</parameter>: This command installs
    106 the man pages to the <filename class="directory">/usr/share/man</filename>
    107 directory.</para>
    108 
    109 </sect2>
    110 
    111 <sect2>
    112 <title>Configuring <application>dhcpcd</application></title>
    113 
    114 <sect3 id="dhcpcd-config"><title>Config files</title>
    115 <para><filename>/var/lib/dhcpc/*</filename></para>
    116 <indexterm zone="dhcpcd dhcpcd-config">
    117 <primary sortas="e-var-lib-dhcpc">/var/lib/dhcpc/*</primary></indexterm>
    118 </sect3>
    119 
    120 <sect3 id="dhcpcd-init"><title>Configuration Information</title>
    121 
    122 <para>To configure <command>dhcpcd</command>, you need to first install
    123 the network service script,
    124 <filename>/etc/sysconfig/network-devices/services/dhcpcd</filename>
    125 included in the <xref linkend="intro-important-bootscripts"/> package
    126 (as user root).</para>
    127 <indexterm zone="dhcpcd dhcpcd-init">
    128 <primary sortas="f-dhcpcd">dhcpcd (service script)</primary></indexterm>
    129 
    130 <screen><userinput role='root'><command>make install-service-dhcpcd</command></userinput></screen>
    131 
    132 <para id="dhcpcd-config2">Finally, as the root user create the
    133 <filename>/etc/sysconfig/network-devices/ifconfig.eth0/dhcpcd</filename>
    134 configuration file using the following commands.  Adjust appropriately
    135 for additional interfaces.</para>
    136 <indexterm zone="dhcpcd dhcpcd-config2">
    137 <primary sortas="e-etc-sysconfig-dhcpcd">/etc/sysconfig/.../dhcpcd</primary></indexterm>
    138 
    139 <screen><userinput role='root'><command>install -d /etc/sysconfig/network-devices/ifconfig.eth0 &amp;&amp;
    140 cat &gt; /etc/sysconfig/network-devices/ifconfig.eth0/dhcpcd &lt;&lt; "EOF"</command>
    141 ONBOOT="yes"
     76    --mandir=/usr/share/man &amp;&amp;
     77make</userinput></screen>
     78   
     79    <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
     80   
     81<screen role="root"><userinput>make install</userinput></screen>
     82   
     83  </sect2>
     84 
     85  <sect2 role="commands">
     86    <title>Command Explanations</title>
     87
     88    <para><command>patch -Np1 -i ../dhcpcd-&dhcpcd-version;-fhs-1.patch</command>:
     89    <application>dhcpcd</application> unpatched puts all configuration
     90    and temporary files in <filename class='directory'>/etc/dhcpc</filename>. This
     91    becomes very annoying when <application>dhcpcd</application> tells you it's
     92    running and it's not. You look in
     93    <filename class="directory">/var/run</filename> for the
     94    <filename>PID</filename> file, but it's not there, the
     95    <filename>PID</filename> file that needs deleting is in
     96    <filename class="directory">/etc/dhcpc</filename>. This patch brings this
     97    program into FHS compliance, but more importantly, puts
     98    files where you expect them to be.</para>
     99   
     100    <para><parameter>--prefix=""</parameter>: There may be a good reason for
     101    abandoning the normal BLFS convention of using
     102    <parameter>--prefix=/usr</parameter> here.  If you are installing
     103    DHCP, it is likely that it is
     104    required during the boot process and
     105    <filename class="directory">/usr</filename> may be network mounted, in which
     106    case <command>dhcpcd</command> wouldn't be available due to being on the
     107    network! Therefore, depending on your situation, you may want it to be
     108    installed in <filename class="directory">/sbin</filename> or
     109    <filename class="directory">/usr/sbin</filename>. This command installs to
     110    <filename class="directory">/sbin</filename>.</para>
     111   
     112    <para><parameter>--sysconfdir=/var/lib</parameter>: This command installs
     113    configuration files in the <filename class="directory">/var/lib</filename>
     114    directory.</para>
     115   
     116    <para><parameter>--mandir=/usr/share/man</parameter>: This command installs
     117    the man pages to the <filename class="directory">/usr/share/man</filename>
     118    directory.</para>
     119   
     120  </sect2>
     121 
     122  <sect2 role="configuration">
     123    <title>Configuring Dhcpcd</title>
     124
     125    <sect3 id="dhcpcd-config">
     126      <title>Config Files</title>
     127     
     128      <para><filename>/var/lib/dhcpc/*</filename></para>
     129     
     130      <indexterm zone="dhcpcd dhcpcd-config">
     131        <primary sortas="e-var-lib-dhcpc">/var/lib/dhcpc/*</primary>
     132      </indexterm>
     133   
     134    </sect3>
     135
     136    <sect3 id="dhcpcd-init">
     137      <title>Configuration Information</title>
     138
     139      <para>To configure <command>dhcpcd</command>, you need to first install
     140      the network service script,
     141      <filename>/etc/sysconfig/network-devices/services/dhcpcd</filename>
     142      included in the <xref linkend="intro-important-bootscripts"/> package
     143      (as user <systemitem class="username">root</systemitem>):</para>
     144     
     145      <indexterm zone="dhcpcd dhcpcd-init">
     146        <primary sortas="f-dhcpcd">dhcpcd (service script)</primary>
     147      </indexterm>
     148
     149<screen role='root'><userinput>make install-service-dhcpcd</userinput></screen>
     150
     151      <para id="dhcpcd-config2">Finally, as the <systemitem
     152      class="username">root</systemitem> user create the
     153      <filename>/etc/sysconfig/network-devices/ifconfig.eth0/dhcpcd</filename>
     154      configuration file using the following commands.  Adjust appropriately
     155      for additional interfaces:</para>
     156     
     157      <indexterm zone="dhcpcd dhcpcd-config2">
     158        <primary sortas="e-etc-sysconfig-dhcpcd">/etc/sysconfig/.../dhcpcd</primary>
     159      </indexterm>
     160
     161<screen role='root'><userinput>install -d /etc/sysconfig/network-devices/ifconfig.eth0 &amp;&amp;
     162cat &gt; /etc/sysconfig/network-devices/ifconfig.eth0/dhcpcd &lt;&lt; "EOF"
     163<literal>ONBOOT="yes"
    142164SERVICE="dhcpcd"
    143165DHCP_START="<replaceable>[insert appropriate start options here]</replaceable>"
    … …  
    150172# Set PRINTALL="yes" to print the DHCP assigned values for
    151173# IP, SM, DG, and 1st NS. This requires PRINTIP="yes".
    152 PRINTALL="no"
    153 <command>EOF</command></userinput></screen>
    154 
    155 <para>For more information on the appropriate <envar>DHCP_START</envar> and
    156 <envar>DHCP_STOP</envar> values, examine the man page for
    157 <command>dhcpcd</command>.</para>
    158 
    159 <note><para id="dhcpcd-config3">The default behavior of
    160 <command>dhcpcd</command> is to overwrite (after making backup copies)
    161 <filename>/etc/resolv.conf</filename>, <filename>/etc/yp.conf</filename> and
    162 <filename>/etc/ntp.conf</filename> with new files containing information from
    163 the <acronym>DHCP</acronym> server. If this is undesirable, review the
    164 <command>dhcpcd</command> man page for switches to add to the
    165 <envar>DHCP_START</envar> value.</para></note>
    166 <indexterm zone="dhcpcd dhcpcd-config3">
    167 <primary sortas="e-etc-resolv.conf">/etc/resolv.conf</primary></indexterm>
    168 <indexterm zone="dhcpcd dhcpcd-config3">
    169 <primary sortas="e-etc-yp.conf">/etc/yp.conf</primary></indexterm>
    170 <indexterm zone="dhcpcd dhcpcd-config3">
    171 <primary sortas="e-etc-ntp.conf">/etc/ntp.conf</primary></indexterm>
    172 
    173 </sect3>
    174 
    175 </sect2>
    176 
    177 <sect2>
    178 <title>Contents</title>
    179 
    180 <segmentedlist>
    181 <segtitle>Installed Program</segtitle>
    182 <segtitle>Installed Libraries</segtitle>
    183 <segtitle>Installed Directories</segtitle>
    184 
    185 <seglistitem>
    186 <seg>dhcpcd</seg>
    187 <seg>None</seg>
    188 <seg>/var/lib/dhcpc</seg>
    189 </seglistitem>
    190 </segmentedlist>
    191 
    192 <variablelist>
    193 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
    194 <?dbfo list-presentation="list"?>
    195 
    196 <varlistentry id="dhcpcd-prog">
    197 <term><command>dhcpcd</command></term>
    198 <listitem><para>is an implementation of the <acronym>DHCP</acronym> client
    199 specified in <acronym>RFC</acronym>2131 and <acronym>RFC</acronym>1541
    200 (depending on which options are specified).</para>
    201 <indexterm zone="dhcpcd dhcpcd-prog">
    202 <primary sortas="b-dhcpcd">dhcpcd</primary>
    203 </indexterm></listitem>
    204 </varlistentry>
    205 </variablelist>
    206 
    207 </sect2>
     174PRINTALL="no"</literal>
     175EOF</userinput></screen>
     176
     177      <para>For more information on the appropriate <envar>DHCP_START</envar> and
     178      <envar>DHCP_STOP</envar> values, examine the man page for
     179      <command>dhcpcd</command>.</para>
     180     
     181      <note>
     182        <para id="dhcpcd-config3">The default behavior of
     183        <command>dhcpcd</command> is to overwrite (after making backup copies)
     184        <filename>/etc/resolv.conf</filename>, <filename>/etc/yp.conf</filename> and
     185        <filename>/etc/ntp.conf</filename> with new files containing information from
     186        the DHCP server. If this is undesirable, review the
     187        <command>dhcpcd</command> man page for switches to add to the
     188        <envar>DHCP_START</envar> value.</para>
     189      </note>
     190     
     191      <indexterm zone="dhcpcd dhcpcd-config3">
     192        <primary sortas="e-etc-resolv.conf">/etc/resolv.conf</primary>
     193      </indexterm>
     194     
     195      <indexterm zone="dhcpcd dhcpcd-config3">
     196        <primary sortas="e-etc-yp.conf">/etc/yp.conf</primary>
     197      </indexterm>
     198     
     199      <indexterm zone="dhcpcd dhcpcd-config3">
     200        <primary sortas="e-etc-ntp.conf">/etc/ntp.conf</primary>
     201      </indexterm>
     202     
     203    </sect3>
     204   
     205  </sect2>
     206 
     207  <sect2 role="content">
     208    <title>Contents</title>
     209
     210    <segmentedlist>
     211      <segtitle>Installed Program</segtitle>
     212      <segtitle>Installed Libraries</segtitle>
     213      <segtitle>Installed Directories</segtitle>
     214     
     215      <seglistitem>
     216        <seg>dhcpcd</seg>
     217        <seg>None</seg>
     218        <seg>/var/lib/dhcpc</seg>
     219      </seglistitem>
     220    </segmentedlist>
     221   
     222    <variablelist>
     223      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
     224      <?dbfo list-presentation="list"?>
     225      <?dbhtml list-presentation="table"?>
     226     
     227      <varlistentry id="dhcpcd-prog">
     228        <term><command>dhcpcd</command></term>
     229        <listitem>
     230          <para>is an implementation of the DHCP client
     231          specified in RFC2131 and RFC1541
     232          (depending on which options are specified).</para>
     233          <indexterm zone="dhcpcd dhcpcd-prog">
     234            <primary sortas="b-dhcpcd">dhcpcd</primary>
     235          </indexterm>
     236        </listitem>
     237      </varlistentry>
     238   
     239    </variablelist>
     240
     241  </sect2>
    208242
    209243</sect1>
Note: See TracChangeset for help on using the changeset viewer.