Changeset fa3e12e1 for networking/connect/dhcp.xml
- Timestamp:
- 12/01/2011 05:09:32 AM (12 years ago)
- Branches:
- 10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 12.0, 12.1, 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:
- f0545c8
- Parents:
- 1f23aa4f
- File:
-
- 1 edited
Legend:
- Unmodified
- Added
- Removed
-
networking/connect/dhcp.xml
r1f23aa4f rfa3e12e1 4 4 <!ENTITY % general-entities SYSTEM "../../general.ent"> 5 5 %general-entities; 6 <!ENTITY dhcp-download-http "http://gd.tuwien.ac.at/infosys/servers/isc/dhcp/dhcp-&dhcp-version;.tar.gz"> 7 <!ENTITY dhcp-download-ftp "ftp://ftp.isc.org/isc/dhcp/dhcp-&dhcp-version;.tar.gz"> 8 <!ENTITY dhcp-md5sum "724bad21ad8b638abadd5fcc07df1a0f"> 9 <!ENTITY dhcp-size "876 KB"> 10 <!ENTITY dhcp-buildsize "21 MB"> 11 <!ENTITY dhcp-time "0.1 SBU"> 6 <!-- isc have a weird way of offering the tarballs and without dots in version! 7 FIXME - change hardcoded 423s in http url and version in ftp when upgrading --> 8 <!ENTITY dhcp-download-http "http://www.isc.org/software/dhcp/423/download/dhcp-423targz?download="> 9 <!ENTITY dhcp-download-ftp "ftp://ftp.isc.org/isc/dhcp/4.2.3/dhcp-&dhcp-version;.tar.gz"> 10 <!ENTITY dhcp-md5sum "a06649ec5336d284fc86a0232c0edd63"> 11 <!ENTITY dhcp-size "9.1 MB"> 12 <!ENTITY dhcp-buildsize "185 MB (client and server), 140MB client only, 172MB server only"> 13 <!ENTITY dhcp-time "0.7 SBU (client and server, or server), 0.6 SBU client only "> 12 14 ]> 13 15 … … 35 37 assigning network addresses on your private network.</para> 36 38 39 &lfs70_checked; 40 37 41 <bridgehead renderas="sect3">Package Information</bridgehead> 38 42 <itemizedlist spacing="compact"> … … 60 64 <itemizedlist spacing='compact'> 61 65 <listitem> 62 <para>Re quired Patch:63 <ulink url="&patch-root;/dhcp-&dhcp-version;- client_dns-1.patch"/></para>66 <para>Recommended Patch (for client): 67 <ulink url="&patch-root;/dhcp-&dhcp-version;-iproute2-1.patch"/></para> 64 68 </listitem> 65 69 <listitem> 66 70 <para>Optional Patch: 67 <ulink url="&patch-root;/dhcp-&dhcp-version;- iproute2-1.patch"/></para>71 <ulink url="&patch-root;/dhcp-&dhcp-version;-missing_ipv6-1.patch"/></para> 68 72 </listitem> 69 73 </itemizedlist> … … 72 76 73 77 <bridgehead renderas="sect4">Required</bridgehead> 74 <para role="required"><xref linkend="net-tools"/> (you may omit 75 <application>net-tools</application> by using the optional patch 76 to utilize <application>iproute2</application>.</para> 78 <para role="required"><xref linkend="net-tools"/> is required at runtime 79 by <command>dhclient</command> if you do not use the iproute2 patch.</para> 77 80 78 81 <para condition="html" role="usernotes">User Notes: … … 84 87 <title>Kernel Configuration</title> 85 88 86 <para>You must have Packet Socket support ( Device Drivers ⇒Networking89 <para>You must have Packet Socket support (Networking 87 90 Support ⇒ Networking Options ⇒ Packet Socket) compiled into 88 the kernel.</para> 91 the kernel. If you do not have IPv6 support (Networking Support ⇒ 92 Networking Options ⇒ The IPv6 Protocol) compiled in, then you 93 must use the missing_ipv6 patch.</para> 89 94 90 95 <indexterm zone="dhcp dhcp-kernel"> … … 97 102 <title>Installation of DHCP</title> 98 103 99 <para>First fix a problem with always regenerating 100 /etc/resolv.conf whether the DNS server has changed or not.</para> 101 102 <screen><userinput>patch -Np1 -i ../dhcp-&dhcp-version;-client_dns-1.patch</userinput></screen> 103 104 <para>If you chose not to install net-tools, apply the 105 iproute2 patch:</para> 104 <para>If you have not compiled IPv6 support into the kernel, apply the 105 missing_ipv6 patch</para> 106 107 <screen><userinput>patch -Np1 -i ../dhcp-&dhcp-version;-missing_ipv6-1.patch</userinput></screen> 108 109 <para>If you are installing the client, apply the iproute2 patch unless you 110 will have installed <application>net-tools</application> by the time you wish 111 to use the client:</para> 106 112 107 113 <screen><userinput>patch -Np1 -i ../dhcp-&dhcp-version;-iproute2-1.patch</userinput></screen> … … 110 116 the following commands:</para> 111 117 112 <screen><userinput>./configure && 113 make</userinput></screen> 114 115 <para>This package does not come with a test suite.</para> 118 <screen><userinput>sed -i 's%\(^sbindir =\).*%\1 @prefix@@sbindir@%' server/Makefile.in && 119 ./configure --prefix=/usr --sysconfdir=/etc --localstatedir=/var \ 120 --sbindir=/sbin \ 121 --with-srv-lease-file=/var/state/dhcp/dhcpd.leases \ 122 --with-srv6-lease-file=/var/state/dhcp/dhcpd6.leases \ 123 --with-cli-lease-file=/var/state/dhclient.leases \ 124 --with-cli6-lease-file=/var/state/dhclient6.leases && 125 sed -i 's/-Werror//' {client,common,dst,omapip,relay,server,tests}/Makefile</userinput></screen> 126 127 <para>If you only wish to build the server, enter:</para> 128 <screen><userinput>sed -i 's/ client//' Makefile</userinput></screen> 129 130 <para>If you only wish to build the client, enter:</para> 131 <screen><userinput>sed -i 's/ dhcpctl relay server//' Makefile</userinput></screen> 132 133 <para>Build your chosen variant(s) with:</para> 134 <screen><userinput>make</userinput></screen> 135 136 <para>To test the results, issue: <command>make check</command></para> 116 137 117 138 <para>Now, as the <systemitem class="username">root</systemitem> user:</para> 118 139 119 <screen role="root"><userinput>make LIBDIR=/usr/lib INCDIR=/usr/include install</userinput></screen> 140 <screen role="root"><userinput>make install</userinput></screen> 141 142 <para>The supplied <filename>/etc/dhcpd.conf</filename> (server) and 143 <filename>/etc/dhclient.conf</filename> (client) are examples for a 144 specific <literal>BSD</literal> system. They are unlikely to be appropriate 145 to your needs, but you may wish to read them for ideas before deleting them 146 or moving them to a different location.</para> 147 148 <para>Now create the director(y,ies) for the leases.</para> 149 150 <para>For the server:</para> 151 152 <screen role="root"><userinput>mkdir -pv /var/state/dhcp</userinput></screen> 153 154 <para>For the client:</para> 155 <screen role="root"><userinput>mkdir -pv /var/state</userinput></screen> 120 156 121 157 </sect2> … … 124 160 <title>Command Explanations</title> 125 161 126 <para><parameter>LIBDIR=/usr/lib INCDIR=/usr/include</parameter>: This 127 command installs the library and include files in 128 <filename class="directory">/usr</filename> instead of 129 <filename class="directory">/usr/local</filename>.</para> 162 <para><command>sed -i 's%\(^sbindir =\).*%\1 @prefix@@sbindir@%' server/Makefile.in</command> 163 This command moves the <command>dhcp</command> program to 164 <filename class='directory'>/usr/sbin</filename> instead of 165 <filename class='directory'>/sbin</filename> because it is not needed 166 while the server is booting.</para> 167 168 <para><command>--sbindir=/sbin</command> The <command>dhclient</command> 169 program is moved to <filename class='directory'>/sbin</filename> instead of 170 <filename class='directory'>/usr/sbin</filename> so that it is available 171 during boot, e.g. if <filename class='directory'>/usr</filename> is to be 172 an <literal>nfs</literal> mount.</para> 173 174 <para><command>--with-*-lease-files=...</command> By default, lease files 175 are placed in <filename class='directory'>/var/db</filename> which is an 176 anachronism.</para> 177 178 <para><command>sed -i 's/-Werror//' {client,common,...}/Makefile</command> - 179 the Makefiles in this package add <literal>-Werror</literal> to the 180 <literal>CFLAGS</literal>. On recent versions of <application>gcc</application> 181 more things, particularly unused variables, create warnings. The 182 <literal>-Werror</literal> flag causes warnings to break the build, so we 183 remove it where necessary.</para> 184 185 <para><command>sed -i 's/ something//' Makefile</command> - this stops the 186 build from entering the director(y,ies) named here.</para> 187 188 <para><option>rm -v /usr/lib/lib{dhcpctl,dst,omapi}.a</option> - there is 189 no easy way to prevent these static libraries being installed, but they are 190 only needed during the build of this package. <filename>libdhcpctl.a</filename> 191 is only installed if you build the server.</para> 130 192 131 193 </sect2> … … 185 247 <literal>default-lease-time 72000; 186 248 max-lease-time 144000; 187 ddns-update-style ad-hoc;188 249 189 250 subnet <replaceable><192.168.5.0></replaceable> netmask <replaceable><255.255.255.0></replaceable> { … … 210 271 <seglistitem> 211 272 <seg>dhcpd, dhcrelay, dhclient, dhclient-script, and omshell</seg> 212 <seg> bdhcpctl.a, libomapi.a</seg>273 <seg>libbdhcpctl.a, libdst.a, libomapi.a</seg> 213 274 <seg>/var/state/dhcp, /usr/include/omapip, and /usr/include/isi-dhcp</seg> 214 275 </seglistitem> … … 226 287 <indexterm zone="dhcp dhclient"> 227 288 <primary sortas="b-dhclient">dhclient</primary> 289 </indexterm> 290 </listitem> 291 </varlistentry> 292 293 <varlistentry id="dhclient-script"> 294 <term><command>dhclient-script</command></term> 295 <listitem> 296 <para>is used by dhclient to (re)configure interfaces. It can make 297 extra changes by invoking custom dhclient-{entry,exit}-hooks.</para> 298 <indexterm zone="dhcp dhclient-script"> 299 <primary sortas="b-dhclient-script">dhclient-script</primary> 228 300 </indexterm> 229 301 </listitem>
Note:
See TracChangeset
for help on using the changeset viewer.