philipp / rpms / dhcp

Forked from rpms/dhcp 4 years ago
Clone

Blame SOURCES/dhcp-4.2.5-manpages.patch

c8bb8f
diff -up dhcp-4.2.5b1/client/dhclient.conf.5.man dhcp-4.2.5b1/client/dhclient.conf.5
c8bb8f
--- dhcp-4.2.5b1/client/dhclient.conf.5.man	2012-12-05 02:17:38.000000000 +0100
c8bb8f
+++ dhcp-4.2.5b1/client/dhclient.conf.5	2012-12-17 12:49:52.818451301 +0100
c8bb8f
@@ -202,7 +202,8 @@ responding to the client send the client
c8bb8f
 options.  Only the option names should be specified in the request
c8bb8f
 statement - not option parameters.  By default, the DHCPv4 client
c8bb8f
 requests the subnet-mask, broadcast-address, time-offset, routers,
c8bb8f
-domain-name, domain-name-servers and host-name options while the DHCPv6
c8bb8f
+domain-search, domain-name, domain-name-servers, host-name, nis-domain,
c8bb8f
+nis-servers, ntp-servers and interface-mtu options while the DHCPv6
c8bb8f
 client requests the dhcp6 name-servers and domain-search options.  Note
c8bb8f
 that if you enter a \'request\' statement, you over-ride these defaults
c8bb8f
 and these options will not be requested.
c8bb8f
@@ -688,6 +689,17 @@ know the DHCP service(s) anycast MAC add
c8bb8f
 client.  The \fIlink-type\fR and \fImac-address\fR parameters are configured
c8bb8f
 in a similar manner to the \fBhardware\fR statement.
c8bb8f
 .PP
c8bb8f
+ \fBbootp-broadcast-always;\fR
c8bb8f
+.PP
c8bb8f
+The
c8bb8f
+.B bootp-broadcast-always
c8bb8f
+statement instructs dhclient to always set the bootp broadcast flag in
c8bb8f
+request packets, so that servers will always broadcast replies.
c8bb8f
+This is equivalent to supplying the dhclient -B argument, and has
c8bb8f
+the same effect as specifying 'always-broadcast' in the server's dhcpd.conf.
c8bb8f
+This option is provided as an extension to enable dhclient to work
c8bb8f
+on IBM s390 Linux guests.
c8bb8f
+.PP
c8bb8f
 .SH SAMPLE
c8bb8f
 The following configuration file is used on a laptop running NetBSD
c8bb8f
 1.3.  The laptop has an IP alias of 192.5.5.213, and has one
c8bb8f
@@ -713,7 +725,7 @@ interface "ep0" {
c8bb8f
     supersede domain-search "fugue.com", "rc.vix.com", "home.vix.com";
c8bb8f
     prepend domain-name-servers 127.0.0.1;
c8bb8f
     request subnet-mask, broadcast-address, time-offset, routers,
c8bb8f
-	    domain-name, domain-name-servers, host-name;
c8bb8f
+	    domain-search, domain-name, domain-name-servers, host-name;
c8bb8f
     require subnet-mask, domain-name-servers;
c8bb8f
     script "CLIENTBINDIR/dhclient-script";
c8bb8f
     media "media 10baseT/UTP", "media 10base2/BNC";
c8bb8f
diff -up dhcp-4.2.5b1/client/dhclient-script.8.man dhcp-4.2.5b1/client/dhclient-script.8
c8bb8f
--- dhcp-4.2.5b1/client/dhclient-script.8.man	2012-12-05 02:17:38.000000000 +0100
c8bb8f
+++ dhcp-4.2.5b1/client/dhclient-script.8	2012-12-17 12:47:48.410130998 +0100
c8bb8f
@@ -48,7 +48,7 @@ customizations are needed, they should b
c8bb8f
 exit hooks provided (see HOOKS for details).   These hooks will allow the
c8bb8f
 user to override the default behaviour of the client in creating a
c8bb8f
 .B /etc/resolv.conf
c8bb8f
-file.
c8bb8f
+file, and to handle DHCP options not handled by default.
c8bb8f
 .PP
c8bb8f
 No standard client script exists for some operating systems, even though
c8bb8f
 the actual client may work, so a pioneering user may well need to create
c8bb8f
@@ -92,6 +92,26 @@ present.   The
c8bb8f
 .B ETCDIR/dhclient-exit-hooks
c8bb8f
 script can modify the valid of exit_status to change the exit status
c8bb8f
 of dhclient-script.
c8bb8f
+.PP
c8bb8f
+Immediately after dhclient brings an interface UP with a new IP address,
c8bb8f
+subnet mask, and routes, in the REBOOT/BOUND states, it will check for the
c8bb8f
+existence of an executable
c8bb8f
+.B ETCDIR/dhclient-up-hooks
c8bb8f
+script, and source it if found. This script can handle DHCP options in
c8bb8f
+the environment that are not handled by default. A per-interface.
c8bb8f
+.B ETCDIR/dhclient-${IF}-up-hooks
c8bb8f
+script will override the generic script and be sourced when interface
c8bb8f
+$IF has been brought up.
c8bb8f
+.PP
c8bb8f
+Immediately before dhclient brings an interface DOWN, removing its IP
c8bb8f
+address, subnet mask, and routes, in the STOP/RELEASE  states, it will
c8bb8f
+check for the existence of an executable
c8bb8f
+.B ETCDIR/dhclient-down-hooks
c8bb8f
+script, and source it if found. This script can handle DHCP options in
c8bb8f
+the environment that are not handled by default. A per-interface
c8bb8f
+.B ETCDIR/dhclient-${IF}-down-hooks
c8bb8f
+script will override the generic script and be sourced when interface
c8bb8f
+$IF is about to be brought down.
c8bb8f
 .SH OPERATION
c8bb8f
 When dhclient needs to invoke the client configuration script, it
c8bb8f
 defines a set of variables in the environment, and then invokes
c8bb8f
diff -up dhcp-4.2.5b1/common/dhcp-options.5.man dhcp-4.2.5b1/common/dhcp-options.5
c8bb8f
--- dhcp-4.2.5b1/common/dhcp-options.5.man	2012-12-05 02:17:38.000000000 +0100
c8bb8f
+++ dhcp-4.2.5b1/common/dhcp-options.5	2012-12-17 12:47:48.411130985 +0100
c8bb8f
@@ -914,6 +914,21 @@ classless IP routing - it does not inclu
c8bb8f
 classless IP routing is now the most widely deployed routing standard,
c8bb8f
 this option is virtually useless, and is not implemented by any of the
c8bb8f
 popular DHCP clients, for example the Microsoft DHCP client.
c8bb8f
+.PP
c8bb8f
+NOTE to Fedora dhclient users:
c8bb8f
+.br
c8bb8f
+dhclient-script interprets trailing 0 octets of the target as indicating
c8bb8f
+the subnet class of the route, so for the following static-routes value:
c8bb8f
+.br
c8bb8f
+        option static-routes 172.0.0.0 172.16.2.254,
c8bb8f
+.br
c8bb8f
+                             192.168.0.0 192.168.2.254;
c8bb8f
+.br
c8bb8f
+dhclient-script will create routes:
c8bb8f
+.br
c8bb8f
+        172/8 via 172.16.2.254 dev $interface
c8bb8f
+.br
c8bb8f
+        192.168/16 via 192.168.2.254 dev $interface
c8bb8f
 .RE
c8bb8f
 .PP
c8bb8f
 .nf
c8bb8f
diff -up dhcp-4.2.5b1/server/dhcpd.conf.5.man dhcp-4.2.5b1/server/dhcpd.conf.5
c8bb8f
--- dhcp-4.2.5b1/server/dhcpd.conf.5.man	2012-12-05 02:17:39.000000000 +0100
c8bb8f
+++ dhcp-4.2.5b1/server/dhcpd.conf.5	2012-12-17 12:50:52.117650542 +0100
c8bb8f
@@ -519,6 +519,9 @@ pool {
c8bb8f
 };
c8bb8f
 .fi
c8bb8f
 .PP
c8bb8f
+Dynamic BOOTP leases are not compatible with failover, and, as such,
c8bb8f
+you need to disallow BOOTP in pools that you are using failover for.
c8bb8f
+.PP
c8bb8f
 The  server currently  does very  little  sanity checking,  so if  you
c8bb8f
 configure it wrong, it will just  fail in odd ways.  I would recommend
c8bb8f
 therefore that you either do  failover or don't do failover, but don't
c8bb8f
@@ -533,9 +536,9 @@ primary server might look like this:
c8bb8f
 failover peer "foo" {
c8bb8f
   primary;
c8bb8f
   address anthrax.rc.vix.com;
c8bb8f
-  port 519;
c8bb8f
+  port 647;
c8bb8f
   peer address trantor.rc.vix.com;
c8bb8f
-  peer port 520;
c8bb8f
+  peer port 847;
c8bb8f
   max-response-delay 60;
c8bb8f
   max-unacked-updates 10;
c8bb8f
   mclt 3600;
c8bb8f
@@ -1318,7 +1321,7 @@ the zone containing PTR records - for IS
c8bb8f
 .PP
c8bb8f
 .nf
c8bb8f
 key DHCP_UPDATER {
c8bb8f
-  algorithm HMAC-MD5.SIG-ALG.REG.INT;
c8bb8f
+  algorithm hmac-md5;
c8bb8f
   secret pRP5FapFoJ95JEL06sv4PQ==;
c8bb8f
 };
c8bb8f
 
c8bb8f
@@ -1341,7 +1344,7 @@ dhcpd.conf file:
c8bb8f
 .PP
c8bb8f
 .nf
c8bb8f
 key DHCP_UPDATER {
c8bb8f
-  algorithm HMAC-MD5.SIG-ALG.REG.INT;
c8bb8f
+  algorithm hmac-md5;
c8bb8f
   secret pRP5FapFoJ95JEL06sv4PQ==;
c8bb8f
 };
c8bb8f
 
c8bb8f
@@ -2555,7 +2558,8 @@ statement
c8bb8f
 The \fInext-server\fR statement is used to specify the host address of
c8bb8f
 the server from which the initial boot file (specified in the
c8bb8f
 \fIfilename\fR statement) is to be loaded.  \fIServer-name\fR should
c8bb8f
-be a numeric IP address or a domain name.
c8bb8f
+be a numeric IP address or a domain name.  If no \fInext-server\fR statement
c8bb8f
+applies to a given client, the address 0.0.0.0 is used.
c8bb8f
 .RE
c8bb8f
 .PP
c8bb8f
 The