Changeset 6ad98e12


Ignore:
Timestamp:
05/18/2005 07:16:15 PM (19 years ago)
Author:
Manuel Canales Esparcia <manuel@…>
Branches:
10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 12.0, 12.1, 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, 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, xry111/intltool, xry111/llvm18, xry111/soup3, xry111/test-20220226, xry111/xf86-video-removal
Children:
be2a00b
Parents:
59bfedf5
Message:

Tagged dhcp.xml

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

File:
1 edited

Legend:

Unmodified
Added
Removed

  • server/other/dhcp.xml

    r59bfedf5 r6ad98e12  
    55  %general-entities;
    66
    7 <!ENTITY dhcp-download-http "http://gd.tuwien.ac.at/infosys/servers/isc/dhcp/dhcp-&dhcp-version;.tar.gz">
    8 <!ENTITY dhcp-download-ftp "ftp://ftp.isc.org/isc/dhcp/dhcp-&dhcp-version;.tar.gz">
    9 <!ENTITY dhcp-md5sum "04800a111521e7442749b2ce883f962b">
    10 <!ENTITY dhcp-size "834 KB">
    11 <!ENTITY dhcp-buildsize "29.7 MB">
    12 <!ENTITY dhcp-time "0.22 SBU">
     7  <!ENTITY dhcp-download-http "http://gd.tuwien.ac.at/infosys/servers/isc/dhcp/dhcp-&dhcp-version;.tar.gz">
     8  <!ENTITY dhcp-download-ftp "ftp://ftp.isc.org/isc/dhcp/dhcp-&dhcp-version;.tar.gz">
     9  <!ENTITY dhcp-md5sum "04800a111521e7442749b2ce883f962b">
     10  <!ENTITY dhcp-size "834 KB">
     11  <!ENTITY dhcp-buildsize "29.7 MB">
     12  <!ENTITY dhcp-time "0.22 SBU">
    1313]>
    1414
    1515<sect1 id="dhcp" xreflabel="DHCP-&dhcp-version;">
    16 <sect1info>
    17   <othername>$LastChangedBy$</othername>
    18   <date>$Date$</date>
    19 </sect1info>
    20 <?dbhtml filename="dhcp.html"?>
    21 <title><acronym>DHCP</acronym>-&dhcp-version;</title>
    22 
    23 <indexterm zone="dhcp">
    24   <primary sortas="a-dhcp">Dhcp</primary>
    25 </indexterm>
    26 
    27 <sect2>
    28 <title>Introduction to
    29 <application><acronym>DHCP</acronym></application></title>
    30 
    31 <para>The <application><acronym>DHCP</acronym></application> package contains
    32 both the client and server programs for <acronym>DHCP</acronym>.
    33 <command>dhclient</command> (the client) is useful for connecting your computer
    34 to a network which uses <acronym>DHCP</acronym> to assign network addresses.
    35 <command>dhcpd</command> (the server) is useful for assigning network addresses
    36 on your private network.</para>
    37 
    38 <sect3><title>Package information</title>
    39 <itemizedlist spacing='compact'>
    40   <listitem><para>Download (HTTP): <ulink url="&dhcp-download-http;"/></para></listitem>
    41   <listitem><para>Download (FTP): <ulink url="&dhcp-download-ftp;"/></para></listitem>
    42   <listitem><para>Download MD5 sum: &dhcp-md5sum;</para></listitem>
    43   <listitem><para>Download size: &dhcp-size;</para></listitem>
    44   <listitem><para>Estimated disk space required: &dhcp-buildsize;</para></listitem>
    45   <listitem><para>Estimated build time: &dhcp-time;</para></listitem>
    46 </itemizedlist>
    47 </sect3>
    48 
    49 <sect3>
    50   <title><application>dhcp</application> dependencies</title>
    51 
    52 <sect4>
    53   <title>Required</title>
    54   <para><xref linkend="net-tools"/> (you may omit <application>net-tools</application>
    55          by using the following patch to utilize <application>iproute2</application>:
    56          <ulink url="&patch-root;/dhcp-&dhcp-version;-iproute2-2.patch"/>)
    57   </para>
    58 </sect4>
    59 </sect3>
    60 
    61 </sect2>
    62 
    63 <sect2 id='dhcp-kernel'>
    64 <title>Installation of
    65 <application><acronym>DHCP</acronym></application></title>
    66 
    67 <note><para>You must have Packet Socket support (Device Drivers -&gt;
    68 Networking Support -&gt; Networking Options -&gt; Packet Socket) compiled into
    69 the kernel.</para></note>
    70 
    71 <indexterm zone="dhcp dhcp-kernel">
    72   <primary sortas="d-dhcp">DHCP</primary>
    73 </indexterm>
    74 
    75 <para>Install <application><acronym>DHCP</acronym></application> by running
    76 the following commands:</para>
    77 
    78 <screen><userinput><command>patch -Np1 -i ../dhcp-&dhcp-version;-iproute2-2.patch &amp;&amp;
     16  <?dbhtml filename="dhcp.html"?>
     17
     18  <sect1info>
     19    <othername>$LastChangedBy$</othername>
     20    <date>$Date$</date>
     21  </sect1info>
     22
     23  <title>DHCP-&dhcp-version;</title>
     24
     25  <indexterm zone="dhcp">
     26    <primary sortas="a-dhcp">Dhcp</primary>
     27  </indexterm>
     28
     29  <sect2 role="package">
     30    <title>Introduction to DHCP</title>
     31
     32    <para>The <application>DHCP</application> package contains both the client
     33    and server programs for DHCP. <command>dhclient</command> (the client) is
     34    useful for connecting your computer to a network which uses DHCP to assign
     35    network addresses. <command>dhcpd</command> (the server) is useful for
     36    assigning network addresses on your private network.</para>
     37
     38    <bridgehead renderas="sect3">Package Information</bridgehead>
     39    <itemizedlist spacing="compact">
     40      <listitem>
     41        <para>Download (HTTP): <ulink url="&dhcp-download-http;"/></para>
     42      </listitem>
     43      <listitem>
     44        <para>Download (FTP): <ulink url="&dhcp-download-ftp;"/></para>
     45      </listitem>
     46      <listitem>
     47        <para>Download MD5 sum: &dhcp-md5sum;</para>
     48      </listitem>
     49      <listitem>
     50        <para>Download size: &dhcp-size;</para>
     51      </listitem>
     52      <listitem>
     53        <para>Estimated disk space required: &dhcp-buildsize;</para>
     54      </listitem>
     55      <listitem>
     56        <para>Estimated build time: &dhcp-time;</para>
     57      </listitem>
     58    </itemizedlist>
     59
     60    <bridgehead renderas="sect3">DHCP Dependencies</bridgehead>
     61
     62    <bridgehead renderas="sect4">Required</bridgehead>
     63    <para><xref linkend="net-tools"/> (you may omit
     64    <application>net-tools</application> by using the following patch
     65    to utilize <application>iproute2</application>:
     66    <ulink url="&patch-root;/dhcp-&dhcp-version;-iproute2-2.patch"/>)</para>
     67
     68  </sect2>
     69
     70  <sect2 role="kernel" id='dhcp-kernel'>
     71    <title>Kernel Configuration</title>
     72
     73    <para>You must have Packet Socket support (Device Drivers -&gt; Networking
     74    Support -&gt; Networking Options -&gt; Packet Socket) compiled into
     75    the kernel.</para>
     76
     77    <indexterm zone="dhcp dhcp-kernel">
     78      <primary sortas="d-dhcp">DHCP</primary>
     79    </indexterm>
     80
     81  </sect2>
     82
     83  <sect2 role="installation">
     84    <title>Installation of DHCP</title>
     85
     86    <para>Install <application>DHCP</application> by running
     87    the following commands:</para>
     88
     89<screen><userinput>patch -Np1 -i ../dhcp-&dhcp-version;-iproute2-2.patch &amp;&amp;
    7990./configure &amp;&amp;
    80 make</command></userinput></screen>
    81 
    82 <para>Now, as the root user:</para>
    83  
    84 <screen><userinput role='root'><command>make LIBDIR=/usr/lib INCDIR=/usr/include install</command></userinput></screen>
    85 
    86 </sect2>
    87 
    88 <sect2>
    89 <title>Command explanations</title>
    90 
    91 <para><parameter>LIBDIR=/usr/lib INCDIR=/usr/include</parameter>: This
    92 command installs the library and include files in
    93 <filename class="directory">/usr</filename> instead of
    94 <filename class="directory">/usr/local</filename>.</para>
    95 
    96 </sect2>
    97 
    98 <sect2 id='dhcp-config'>
    99 <title>Configuring <application><acronym>DHCP</acronym></application></title>
    100 
    101  <indexterm zone="dhcp dhcp-config">
    102     <primary sortas="e-etc-dhclient.conf">/etc/dhclient.conf</primary>
    103  </indexterm>
    104 
    105  <indexterm zone="dhcp dhcp-config">
    106     <primary sortas="e-etc-dhcpd.conf">/etc/dhcpd.conf</primary>
    107  </indexterm>
    108 
    109 
    110 <sect3>
    111 <title>Config files</title>
    112 <para><filename>/etc/dhclient.conf</filename></para>
    113 </sect3>
    114 
    115 <sect3 id='dhcp-init'>
    116 <title>Configuration Information</title>
    117 
    118 <para>Information on configuring the <acronym>DHCP</acronym> client can be
    119 found in <xref linkend="connect-dhcp"/>.</para>
    120 
    121 <para>Note that you only need the <acronym>DHCP</acronym> server if
    122 you want to issue <acronym>LAN</acronym> addresses over your network.  The
    123 <acronym>DHCP</acronym> client doesn't need this script to be used.  Also note
    124 that this script is coded for the <emphasis role="strong">eth1</emphasis>
    125 interface, which may need to be modified for your hardware configuration.</para>
    126 
    127 <para>Install the <filename>/etc/rc.d/init.d/dhcp</filename>
    128 init script included in the <xref linkend="intro-important-bootscripts"/>
    129 package.</para>
    130 
    131  <indexterm zone="dhcp dhcp-init">
    132     <primary sortas="f-dhcp">dhcpd</primary>
    133  </indexterm>
    134 
    135 <screen><userinput><command>make install-dhcp</command></userinput></screen>
    136 
    137 <para>The lease file must exist on startup.  The following command will
    138 satisfy that requirement:</para>
    139 
    140 <screen><userinput><command>touch /var/state/dhcp/dhcpd.leases</command></userinput></screen>
    141 
    142 <para>The following commands will create a base configuration file for a
    143 <acronym>DHCP</acronym> server.  There are several options that you may want to
    144 add (information that is passed back to the <acronym>DHCP</acronym> client) and
    145 those are covered in the man pages for <filename>dhcp.conf</filename>.</para>
    146 
    147 <screen><userinput><command>cat &gt; /etc/dhcpd.conf &lt;&lt; "EOF"</command>
    148 default-lease-time 72000;
     91make</userinput></screen>
     92
     93    <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
     94
     95<screen role="root"><userinput>make LIBDIR=/usr/lib INCDIR=/usr/include install</userinput></screen>
     96
     97  </sect2>
     98
     99  <sect2 role="commands">
     100    <title>Command Explanations</title>
     101
     102    <para><parameter>LIBDIR=/usr/lib INCDIR=/usr/include</parameter>: This
     103    command installs the library and include files in
     104    <filename class="directory">/usr</filename> instead of
     105    <filename class="directory">/usr/local</filename>.</para>
     106
     107  </sect2>
     108
     109  <sect2 role="configuration">
     110    <title>Configuring DHCP</title>
     111
     112    <sect3 id='dhcp-config'>
     113      <title>Config Files</title>
     114
     115      <para><filename>/etc/dhclient.conf</filename> and
     116      <filename>/etc/dhcpd.conf</filename></para>
     117
     118      <indexterm zone="dhcp dhcp-config">
     119        <primary sortas="e-etc-dhclient.conf">/etc/dhclient.conf</primary>
     120      </indexterm>
     121
     122      <indexterm zone="dhcp dhcp-config">
     123        <primary sortas="e-etc-dhcpd.conf">/etc/dhcpd.conf</primary>
     124      </indexterm>
     125
     126    </sect3>
     127
     128    <sect3 id='dhcp-init'>
     129      <title>Configuration Information</title>
     130
     131      <para>Information on configuring the DHCP client can be
     132      found in <xref linkend="connect-dhcp"/>.</para>
     133
     134      <para>Note that you only need the DHCP server if you want to issue
     135      LAN addresses over your network. The DHCP client doesn't need this
     136      script to be used.  Also note that this script is coded for the
     137      <emphasis role="strong">eth1</emphasis> interface, which may need
     138      to be modified for your hardware configuration.</para>
     139
     140      <para>Install the <filename>/etc/rc.d/init.d/dhcp</filename>
     141      init script included in the <xref linkend="intro-important-bootscripts"/>
     142      package.</para>
     143
     144      <indexterm zone="dhcp dhcp-init">
     145        <primary sortas="f-dhcp">dhcpd</primary>
     146      </indexterm>
     147
     148<screen role="root"><userinput>make install-dhcp</userinput></screen>
     149
     150      <para>The lease file must exist on startup. The following command will
     151      satisfy that requirement:</para>
     152
     153<screen role="root"><userinput>touch /var/state/dhcp/dhcpd.leases</userinput></screen>
     154
     155      <para>The following commands will create a base configuration file
     156      for a DHCP server.  There are several options that you may want to
     157      add (information that is passed back to the DHCP client) and those
     158      are covered in the man pages for <filename>dhcp.conf</filename>.</para>
     159
     160<screen role="root"><userinput>cat &gt; /etc/dhcpd.conf &lt;&lt; "EOF"
     161<literal>default-lease-time 72000;
    149162max-lease-time 144000;
    150163ddns-update-style ad-hoc;
    … …  
    154167  option broadcast-address <replaceable>[192.168.5.255]</replaceable>;
    155168  option routers <replaceable>[192.168.5.1]</replaceable>;
    156 }
    157 <command>EOF</command></userinput></screen>
    158 
    159 <para>All addresses should be changed to meet your circumstance.</para>
    160 
    161 </sect3>
    162 
    163 </sect2>
    164 
    165 <sect2>
    166 <title>Contents</title>
    167 
    168 <segmentedlist>
    169   <segtitle>Installed Programs</segtitle>
    170   <segtitle>Installed Libraries</segtitle>
    171   <segtitle>Installed Directories</segtitle>
    172  
    173   <seglistitem>
    174     <seg>dhcpd, dhcrelay, dhclient, dhclient-script, omshell</seg>
    175     <seg>bdhcpctl.a, libomapi.a</seg>
    176     <seg>/var/state/dhcp, /usr/include/omapip, /usr/include/isi-dhcp</seg>
    177   </seglistitem>
    178 </segmentedlist>
    179  
    180 <variablelist>
    181   <bridgehead renderas="sect3">Short Descriptions</bridgehead>
    182   <?dbfo list-presentation="list"?>
    183 
    184 <varlistentry id="dhclient">
    185   <term><command>dhclient</command></term>
    186   <listitem>
    187     <para>is the implementation of the <acronym>DHCP</acronym> client.</para>
    188     <indexterm zone="dhcp dhclient">
    189       <primary sortas="b-dhclient">dhclient</primary>
    190     </indexterm>
    191   </listitem>
    192 </varlistentry>
    193 
    194 <varlistentry id="dhcpd">
    195   <term><command>dhcpd</command></term>
    196   <listitem>
    197     <para>implements Dynamic Host Configuration Protocol (<acronym>DHCP</acronym>)
    198           and Internet Bootstrap Protocol (<acronym>BOOTP</acronym>) requests for
    199           network addresses.</para>
    200     <indexterm zone="dhcp dhcpd">
    201       <primary sortas="b-dhcpd">dhcpd</primary>
    202     </indexterm>
    203   </listitem>
    204 </varlistentry>
    205 
    206 <varlistentry id="dhcrelay">
    207   <term><command>dhcrelay</command></term>
    208   <listitem>
    209     <para>provides a means to accept <acronym>DHCP</acronym> and <acronym>BOOTP</acronym>
    210           requests on a subnet without a <acronym>DHCP</acronym> server and relay them to
    211           a <acronym>DHCP</acronym> server on another subnet.</para>
    212     <indexterm zone="dhcp dhcrelay">
    213       <primary sortas="b-dhcrelay">dhcrelay</primary>
    214     </indexterm>
    215   </listitem>
    216 </varlistentry>
    217 
    218 <varlistentry id="omshell">
    219   <term><command>omshell</command></term>
    220   <listitem>
    221     <para> provides an interactive way to connect to, query, and possibly change,
    222            the ISC DHCP Server's state via OMAPI, the Object Management API.</para>
    223     <indexterm zone="dhcp omshell">
    224       <primary sortas="b-omshell">omshell</primary>
    225     </indexterm>
    226   </listitem>
    227 </varlistentry>
    228 
    229 </variablelist>
    230 </sect2>
     169}</literal>
     170EOF</userinput></screen>
     171
     172      <para>All addresses should be changed to meet your circumstance.</para>
     173
     174    </sect3>
     175
     176  </sect2>
     177
     178  <sect2 role="content">
     179    <title>Contents</title>
     180
     181    <segmentedlist>
     182      <segtitle>Installed Programs</segtitle>
     183      <segtitle>Installed Libraries</segtitle>
     184      <segtitle>Installed Directories</segtitle>
     185
     186      <seglistitem>
     187        <seg>dhcpd, dhcrelay, dhclient, dhclient-script, and omshell</seg>
     188        <seg>bdhcpctl.a, libomapi.a</seg>
     189        <seg>/var/state/dhcp, /usr/include/omapip, and /usr/include/isi-dhcp</seg>
     190      </seglistitem>
     191    </segmentedlist>
     192
     193    <variablelist>
     194      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
     195      <?dbfo list-presentation="list"?>
     196      <?dbhtml list-presentation="table"?>
     197
     198      <varlistentry id="dhclient">
     199        <term><command>dhclient</command></term>
     200        <listitem>
     201          <para>is the implementation of the DHCP client.</para>
     202          <indexterm zone="dhcp dhclient">
     203            <primary sortas="b-dhclient">dhclient</primary>
     204          </indexterm>
     205        </listitem>
     206      </varlistentry>
     207
     208      <varlistentry id="dhcpd">
     209        <term><command>dhcpd</command></term>
     210        <listitem>
     211          <para>implements Dynamic Host Configuration Protocol (DHCP) and
     212          Internet Bootstrap Protocol (BOOTP) requests for network
     213          addresses.</para>
     214          <indexterm zone="dhcp dhcpd">
     215            <primary sortas="b-dhcpd">dhcpd</primary>
     216          </indexterm>
     217        </listitem>
     218      </varlistentry>
     219
     220      <varlistentry id="dhcrelay">
     221        <term><command>dhcrelay</command></term>
     222        <listitem>
     223          <para>provides a means to accept DHCP and BOOTP requests on a subnet
     224          without a DHCP server and relay them to a DHCP server on another
     225          subnet.</para>
     226          <indexterm zone="dhcp dhcrelay">
     227            <primary sortas="b-dhcrelay">dhcrelay</primary>
     228          </indexterm>
     229        </listitem>
     230      </varlistentry>
     231
     232      <varlistentry id="omshell">
     233        <term><command>omshell</command></term>
     234        <listitem>
     235          <para> provides an interactive way to connect to, query, and
     236          possibly change, the ISC DHCP Server's state via OMAPI, the
     237          Object Management API.</para>
     238          <indexterm zone="dhcp omshell">
     239            <primary sortas="b-omshell">omshell</primary>
     240          </indexterm>
     241        </listitem>
     242      </varlistentry>
     243
     244    </variablelist>
     245
     246  </sect2>
     247
    231248</sect1>
    232 
Note: See TracChangeset for help on using the changeset viewer.