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