Tagged dhcp.xml

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@4357 af4574ff-66df-0310-9fd7-8a98e5e911e0
This commit is contained in:
Manuel Canales Esparcia 2005-05-18 19:16:15 +00:00
parent 59bfedf5e4
commit 6ad98e1299

View File

@ -4,148 +4,161 @@
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
<!ENTITY dhcp-download-http "http://gd.tuwien.ac.at/infosys/servers/isc/dhcp/dhcp-&dhcp-version;.tar.gz">
<!ENTITY dhcp-download-ftp "ftp://ftp.isc.org/isc/dhcp/dhcp-&dhcp-version;.tar.gz">
<!ENTITY dhcp-md5sum "04800a111521e7442749b2ce883f962b">
<!ENTITY dhcp-size "834 KB">
<!ENTITY dhcp-buildsize "29.7 MB">
<!ENTITY dhcp-time "0.22 SBU">
<!ENTITY dhcp-download-http "http://gd.tuwien.ac.at/infosys/servers/isc/dhcp/dhcp-&dhcp-version;.tar.gz">
<!ENTITY dhcp-download-ftp "ftp://ftp.isc.org/isc/dhcp/dhcp-&dhcp-version;.tar.gz">
<!ENTITY dhcp-md5sum "04800a111521e7442749b2ce883f962b">
<!ENTITY dhcp-size "834 KB">
<!ENTITY dhcp-buildsize "29.7 MB">
<!ENTITY dhcp-time "0.22 SBU">
]>
<sect1 id="dhcp" xreflabel="DHCP-&dhcp-version;">
<sect1info>
<othername>$LastChangedBy$</othername>
<date>$Date$</date>
</sect1info>
<?dbhtml filename="dhcp.html"?>
<title><acronym>DHCP</acronym>-&dhcp-version;</title>
<?dbhtml filename="dhcp.html"?>
<indexterm zone="dhcp">
<primary sortas="a-dhcp">Dhcp</primary>
</indexterm>
<sect1info>
<othername>$LastChangedBy$</othername>
<date>$Date$</date>
</sect1info>
<sect2>
<title>Introduction to
<application><acronym>DHCP</acronym></application></title>
<title>DHCP-&dhcp-version;</title>
<para>The <application><acronym>DHCP</acronym></application> package contains
both the client and server programs for <acronym>DHCP</acronym>.
<command>dhclient</command> (the client) is useful for connecting your computer
to a network which uses <acronym>DHCP</acronym> to assign network addresses.
<command>dhcpd</command> (the server) is useful for assigning network addresses
on your private network.</para>
<indexterm zone="dhcp">
<primary sortas="a-dhcp">Dhcp</primary>
</indexterm>
<sect3><title>Package information</title>
<itemizedlist spacing='compact'>
<listitem><para>Download (HTTP): <ulink url="&dhcp-download-http;"/></para></listitem>
<listitem><para>Download (FTP): <ulink url="&dhcp-download-ftp;"/></para></listitem>
<listitem><para>Download MD5 sum: &dhcp-md5sum;</para></listitem>
<listitem><para>Download size: &dhcp-size;</para></listitem>
<listitem><para>Estimated disk space required: &dhcp-buildsize;</para></listitem>
<listitem><para>Estimated build time: &dhcp-time;</para></listitem>
</itemizedlist>
</sect3>
<sect2 role="package">
<title>Introduction to DHCP</title>
<sect3>
<title><application>dhcp</application> dependencies</title>
<para>The <application>DHCP</application> package contains both the client
and server programs for DHCP. <command>dhclient</command> (the client) is
useful for connecting your computer to a network which uses DHCP to assign
network addresses. <command>dhcpd</command> (the server) is useful for
assigning network addresses on your private network.</para>
<sect4>
<title>Required</title>
<para><xref linkend="net-tools"/> (you may omit <application>net-tools</application>
by using the following patch to utilize <application>iproute2</application>:
<ulink url="&patch-root;/dhcp-&dhcp-version;-iproute2-2.patch"/>)
</para>
</sect4>
</sect3>
<bridgehead renderas="sect3">Package Information</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>Download (HTTP): <ulink url="&dhcp-download-http;"/></para>
</listitem>
<listitem>
<para>Download (FTP): <ulink url="&dhcp-download-ftp;"/></para>
</listitem>
<listitem>
<para>Download MD5 sum: &dhcp-md5sum;</para>
</listitem>
<listitem>
<para>Download size: &dhcp-size;</para>
</listitem>
<listitem>
<para>Estimated disk space required: &dhcp-buildsize;</para>
</listitem>
<listitem>
<para>Estimated build time: &dhcp-time;</para>
</listitem>
</itemizedlist>
</sect2>
<bridgehead renderas="sect3">DHCP Dependencies</bridgehead>
<sect2 id='dhcp-kernel'>
<title>Installation of
<application><acronym>DHCP</acronym></application></title>
<bridgehead renderas="sect4">Required</bridgehead>
<para><xref linkend="net-tools"/> (you may omit
<application>net-tools</application> by using the following patch
to utilize <application>iproute2</application>:
<ulink url="&patch-root;/dhcp-&dhcp-version;-iproute2-2.patch"/>)</para>
<note><para>You must have Packet Socket support (Device Drivers -&gt;
Networking Support -&gt; Networking Options -&gt; Packet Socket) compiled into
the kernel.</para></note>
</sect2>
<indexterm zone="dhcp dhcp-kernel">
<primary sortas="d-dhcp">DHCP</primary>
</indexterm>
<sect2 role="kernel" id='dhcp-kernel'>
<title>Kernel Configuration</title>
<para>Install <application><acronym>DHCP</acronym></application> by running
the following commands:</para>
<para>You must have Packet Socket support (Device Drivers -&gt; Networking
Support -&gt; Networking Options -&gt; Packet Socket) compiled into
the kernel.</para>
<screen><userinput><command>patch -Np1 -i ../dhcp-&dhcp-version;-iproute2-2.patch &amp;&amp;
<indexterm zone="dhcp dhcp-kernel">
<primary sortas="d-dhcp">DHCP</primary>
</indexterm>
</sect2>
<sect2 role="installation">
<title>Installation of DHCP</title>
<para>Install <application>DHCP</application> by running
the following commands:</para>
<screen><userinput>patch -Np1 -i ../dhcp-&dhcp-version;-iproute2-2.patch &amp;&amp;
./configure &amp;&amp;
make</command></userinput></screen>
make</userinput></screen>
<para>Now, as the root user:</para>
<screen><userinput role='root'><command>make LIBDIR=/usr/lib INCDIR=/usr/include install</command></userinput></screen>
<para>Now, as the <systemitem class="username">root</systemitem> user:</para>
</sect2>
<screen role="root"><userinput>make LIBDIR=/usr/lib INCDIR=/usr/include install</userinput></screen>
<sect2>
<title>Command explanations</title>
</sect2>
<para><parameter>LIBDIR=/usr/lib INCDIR=/usr/include</parameter>: This
command installs the library and include files in
<filename class="directory">/usr</filename> instead of
<filename class="directory">/usr/local</filename>.</para>
<sect2 role="commands">
<title>Command Explanations</title>
</sect2>
<para><parameter>LIBDIR=/usr/lib INCDIR=/usr/include</parameter>: This
command installs the library and include files in
<filename class="directory">/usr</filename> instead of
<filename class="directory">/usr/local</filename>.</para>
<sect2 id='dhcp-config'>
<title>Configuring <application><acronym>DHCP</acronym></application></title>
</sect2>
<indexterm zone="dhcp dhcp-config">
<primary sortas="e-etc-dhclient.conf">/etc/dhclient.conf</primary>
</indexterm>
<sect2 role="configuration">
<title>Configuring DHCP</title>
<indexterm zone="dhcp dhcp-config">
<primary sortas="e-etc-dhcpd.conf">/etc/dhcpd.conf</primary>
</indexterm>
<sect3 id='dhcp-config'>
<title>Config Files</title>
<para><filename>/etc/dhclient.conf</filename> and
<filename>/etc/dhcpd.conf</filename></para>
<sect3>
<title>Config files</title>
<para><filename>/etc/dhclient.conf</filename></para>
</sect3>
<indexterm zone="dhcp dhcp-config">
<primary sortas="e-etc-dhclient.conf">/etc/dhclient.conf</primary>
</indexterm>
<sect3 id='dhcp-init'>
<title>Configuration Information</title>
<indexterm zone="dhcp dhcp-config">
<primary sortas="e-etc-dhcpd.conf">/etc/dhcpd.conf</primary>
</indexterm>
<para>Information on configuring the <acronym>DHCP</acronym> client can be
found in <xref linkend="connect-dhcp"/>.</para>
</sect3>
<para>Note that you only need the <acronym>DHCP</acronym> server if
you want to issue <acronym>LAN</acronym> addresses over your network. The
<acronym>DHCP</acronym> client doesn't need this script to be used. Also note
that this script is coded for the <emphasis role="strong">eth1</emphasis>
interface, which may need to be modified for your hardware configuration.</para>
<sect3 id='dhcp-init'>
<title>Configuration Information</title>
<para>Install the <filename>/etc/rc.d/init.d/dhcp</filename>
init script included in the <xref linkend="intro-important-bootscripts"/>
package.</para>
<para>Information on configuring the DHCP client can be
found in <xref linkend="connect-dhcp"/>.</para>
<indexterm zone="dhcp dhcp-init">
<primary sortas="f-dhcp">dhcpd</primary>
</indexterm>
<para>Note that you only need the DHCP server if you want to issue
LAN addresses over your network. The DHCP client doesn't need this
script to be used. Also note that this script is coded for the
<emphasis role="strong">eth1</emphasis> interface, which may need
to be modified for your hardware configuration.</para>
<screen><userinput><command>make install-dhcp</command></userinput></screen>
<para>Install the <filename>/etc/rc.d/init.d/dhcp</filename>
init script included in the <xref linkend="intro-important-bootscripts"/>
package.</para>
<para>The lease file must exist on startup. The following command will
satisfy that requirement:</para>
<indexterm zone="dhcp dhcp-init">
<primary sortas="f-dhcp">dhcpd</primary>
</indexterm>
<screen><userinput><command>touch /var/state/dhcp/dhcpd.leases</command></userinput></screen>
<screen role="root"><userinput>make install-dhcp</userinput></screen>
<para>The following commands will create a base configuration file for a
<acronym>DHCP</acronym> server. There are several options that you may want to
add (information that is passed back to the <acronym>DHCP</acronym> client) and
those are covered in the man pages for <filename>dhcp.conf</filename>.</para>
<para>The lease file must exist on startup. The following command will
satisfy that requirement:</para>
<screen><userinput><command>cat &gt; /etc/dhcpd.conf &lt;&lt; "EOF"</command>
default-lease-time 72000;
<screen role="root"><userinput>touch /var/state/dhcp/dhcpd.leases</userinput></screen>
<para>The following commands will create a base configuration file
for a DHCP server. There are several options that you may want to
add (information that is passed back to the DHCP client) and those
are covered in the man pages for <filename>dhcp.conf</filename>.</para>
<screen role="root"><userinput>cat &gt; /etc/dhcpd.conf &lt;&lt; "EOF"
<literal>default-lease-time 72000;
max-lease-time 144000;
ddns-update-style ad-hoc;
@ -153,80 +166,83 @@ subnet <replaceable>[192.168.5.0]</replaceable> netmask <replaceable>[255.255.25
range <replaceable>[192.168.5.10] [192.168.5.240]</replaceable>;
option broadcast-address <replaceable>[192.168.5.255]</replaceable>;
option routers <replaceable>[192.168.5.1]</replaceable>;
}
<command>EOF</command></userinput></screen>
}</literal>
EOF</userinput></screen>
<para>All addresses should be changed to meet your circumstance.</para>
<para>All addresses should be changed to meet your circumstance.</para>
</sect3>
</sect3>
</sect2>
</sect2>
<sect2>
<title>Contents</title>
<sect2 role="content">
<title>Contents</title>
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directories</segtitle>
<seglistitem>
<seg>dhcpd, dhcrelay, dhclient, dhclient-script, omshell</seg>
<seg>bdhcpctl.a, libomapi.a</seg>
<seg>/var/state/dhcp, /usr/include/omapip, /usr/include/isi-dhcp</seg>
</seglistitem>
</segmentedlist>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directories</segtitle>
<varlistentry id="dhclient">
<term><command>dhclient</command></term>
<listitem>
<para>is the implementation of the <acronym>DHCP</acronym> client.</para>
<indexterm zone="dhcp dhclient">
<primary sortas="b-dhclient">dhclient</primary>
</indexterm>
</listitem>
</varlistentry>
<seglistitem>
<seg>dhcpd, dhcrelay, dhclient, dhclient-script, and omshell</seg>
<seg>bdhcpctl.a, libomapi.a</seg>
<seg>/var/state/dhcp, /usr/include/omapip, and /usr/include/isi-dhcp</seg>
</seglistitem>
</segmentedlist>
<varlistentry id="dhcpd">
<term><command>dhcpd</command></term>
<listitem>
<para>implements Dynamic Host Configuration Protocol (<acronym>DHCP</acronym>)
and Internet Bootstrap Protocol (<acronym>BOOTP</acronym>) requests for
network addresses.</para>
<indexterm zone="dhcp dhcpd">
<primary sortas="b-dhcpd">dhcpd</primary>
</indexterm>
</listitem>
</varlistentry>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
<varlistentry id="dhcrelay">
<term><command>dhcrelay</command></term>
<listitem>
<para>provides a means to accept <acronym>DHCP</acronym> and <acronym>BOOTP</acronym>
requests on a subnet without a <acronym>DHCP</acronym> server and relay them to
a <acronym>DHCP</acronym> server on another subnet.</para>
<indexterm zone="dhcp dhcrelay">
<primary sortas="b-dhcrelay">dhcrelay</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="dhclient">
<term><command>dhclient</command></term>
<listitem>
<para>is the implementation of the DHCP client.</para>
<indexterm zone="dhcp dhclient">
<primary sortas="b-dhclient">dhclient</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="omshell">
<term><command>omshell</command></term>
<listitem>
<para> provides an interactive way to connect to, query, and possibly change,
the ISC DHCP Server's state via OMAPI, the Object Management API.</para>
<indexterm zone="dhcp omshell">
<primary sortas="b-omshell">omshell</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="dhcpd">
<term><command>dhcpd</command></term>
<listitem>
<para>implements Dynamic Host Configuration Protocol (DHCP) and
Internet Bootstrap Protocol (BOOTP) requests for network
addresses.</para>
<indexterm zone="dhcp dhcpd">
<primary sortas="b-dhcpd">dhcpd</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="dhcrelay">
<term><command>dhcrelay</command></term>
<listitem>
<para>provides a means to accept DHCP and BOOTP requests on a subnet
without a DHCP server and relay them to a DHCP server on another
subnet.</para>
<indexterm zone="dhcp dhcrelay">
<primary sortas="b-dhcrelay">dhcrelay</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="omshell">
<term><command>omshell</command></term>
<listitem>
<para> provides an interactive way to connect to, query, and
possibly change, the ISC DHCP Server's state via OMAPI, the
Object Management API.</para>
<indexterm zone="dhcp omshell">
<primary sortas="b-omshell">omshell</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect2>
</variablelist>
</sect2>
</sect1>