ssahani / rpms / dhcp

Forked from rpms/dhcp 5 years ago
Clone
0f33b63
diff -up dhcp-3.0.6/dhcpctl/dhcpctl.3.manpages dhcp-3.0.6/dhcpctl/dhcpctl.3
0f33b63
--- dhcp-3.0.6/dhcpctl/dhcpctl.3.manpages	2004-09-24 17:08:38.000000000 -0400
0f33b63
+++ dhcp-3.0.6/dhcpctl/dhcpctl.3	2007-09-26 15:22:12.000000000 -0400
0f33b63
@@ -43,7 +43,7 @@
0f33b63
 .\"
0f33b63
 .\"
0f33b63
 .Sh SYNOPSIS
0f33b63
-.Fd #include <dhcpctl/dhcpctl.h>
0f33b63
+.Fd #include <dhcpctl.h>
0f33b63
 .Ft dhcpctl_status
0f33b63
 .Fo dhcpctl_initialize
0f33b63
 .Fa void
0f33b63
@@ -426,7 +426,7 @@ that most error checking has been ommitt
0f33b63
 #include <netinet/in.h>
0f33b63
 
0f33b63
 #include <isc/result.h>
0f33b63
-#include <dhcpctl/dhcpctl.h>
0f33b63
+#include <dhcpctl.h>
0f33b63
 
0f33b63
 int main (int argc, char **argv) {
0f33b63
 	dhcpctl_data_string ipaddrstring = NULL;
0f33b63
diff -up dhcp-3.0.6/server/dhcpd.conf.5.manpages dhcp-3.0.6/server/dhcpd.conf.5
0f33b63
--- dhcp-3.0.6/server/dhcpd.conf.5.manpages	2007-05-01 16:42:56.000000000 -0400
0f33b63
+++ dhcp-3.0.6/server/dhcpd.conf.5	2007-09-26 15:24:18.000000000 -0400
0f33b63
@@ -531,9 +531,9 @@ primary server might look like this:
0f33b63
 failover peer "foo" {
0f33b63
   primary;
0f33b63
   address anthrax.rc.vix.com;
0f33b63
-  port 519;
0f33b63
+  port 647;
0f33b63
   peer address trantor.rc.vix.com;
0f33b63
-  peer port 520;
0f33b63
+  peer port 847;
0f33b63
   max-response-delay 60;
0f33b63
   max-unacked-updates 10;
0f33b63
   mclt 3600;
0f33b63
@@ -592,9 +592,7 @@ statement
0f33b63
 .B port \fIport-number\fR\fB;\fR
0f33b63
 .PP
0f33b63
 The \fBport\fR statement declares the TCP port on which the server
0f33b63
-should listen for connections from its failover peer.   This statement
0f33b63
-may not currently be omitted, because the failover protocol does not
0f33b63
-yet have a reserved TCP port number.
0f33b63
+should listen for connections from its failover peer.
0f33b63
 .RE
0f33b63
 .PP
0f33b63
 The 
0f33b63
@@ -606,10 +604,8 @@ statement
0f33b63
 .PP
0f33b63
 The \fBpeer port\fR statement declares the TCP port to which the
0f33b63
 server should connect to reach its failover peer for failover
0f33b63
-messages.   This statement may not be omitted because the failover
0f33b63
-protocol does not yet have a reserved TCP port number.   The port
0f33b63
-number declared in the \fBpeer port\fR statement may be the same as
0f33b63
-the port number declared in the \fBport\fR statement.
0f33b63
+messages. The port number declared in the \fBpeer port\fR statement
0f33b63
+may be the same as the port number declared in the \fBport\fR statement.
0f33b63
 .RE
0f33b63
 .PP
0f33b63
 The 
0f33b63
@@ -1133,7 +1129,7 @@ the zone containing PTR records - for IS
0f33b63
 .PP
0f33b63
 .nf
0f33b63
 key DHCP_UPDATER {
0f33b63
-  algorithm HMAC-MD5.SIG-ALG.REG.INT;
0f33b63
+  algorithm hmac-md5;
0f33b63
   secret pRP5FapFoJ95JEL06sv4PQ==;
0f33b63
 };
0f33b63
 
0f33b63
@@ -1156,7 +1152,7 @@ dhcpd.conf file:
0f33b63
 .PP
0f33b63
 .nf
0f33b63
 key DHCP_UPDATER {
0f33b63
-  algorithm HMAC-MD5.SIG-ALG.REG.INT;
0f33b63
+  algorithm hmac-md5;
0f33b63
   secret pRP5FapFoJ95JEL06sv4PQ==;
0f33b63
 };
0f33b63
 
0f33b63
@@ -2114,7 +2110,8 @@ statement
0f33b63
 The \fInext-server\fR statement is used to specify the host address of
0f33b63
 the server from which the initial boot file (specified in the
0f33b63
 \fIfilename\fR statement) is to be loaded.   \fIServer-name\fR should
0f33b63
-be a numeric IP address or a domain name.
0f33b63
+be a numeric IP address or a domain name.  If no \fInext-server\fR statement
0f33b63
+applies to a given client, the address 0.0.0.0 is used.
0f33b63
 .RE
0f33b63
 .PP
0f33b63
 The
0f33b63
diff -up dhcp-3.0.6/common/dhcp-options.5.manpages dhcp-3.0.6/common/dhcp-options.5
0f33b63
--- dhcp-3.0.6/common/dhcp-options.5.manpages	2006-04-26 11:12:43.000000000 -0400
0f33b63
+++ dhcp-3.0.6/common/dhcp-options.5	2007-09-26 15:22:12.000000000 -0400
0f33b63
@@ -834,6 +834,24 @@ classless IP routing - it does not inclu
0f33b63
 classless IP routing is now the most widely deployed routing standard,
0f33b63
 this option is virtually useless, and is not implemented by any of the
0f33b63
 popular DHCP clients, for example the Microsoft DHCP client.
0f33b63
+.PP
0f33b63
+NOTE to Red Hat dhclient users:
0f33b63
+.br
0f33b63
+The RedHat dhclient-script interprets trailing 0 octets of the target
0f33b63
+as indicating the subnet class of the route - so for this
0f33b63
+static-routes value:
0f33b63
+.br
0f33b63
+        option static-routes 172.0.0.0 172.16.2.254,
0f33b63
+.br
0f33b63
+                             192.168.0.0 192.168.2.254;
0f33b63
+.br
0f33b63
+the Red Hat dhclient-script will create routes:
0f33b63
+.br
0f33b63
+        172/8 via 172.16.2.254 dev $interface
0f33b63
+.br
0f33b63
+        192.168/16 via 192.168.2.254 dev $interface
0f33b63
+.br
0f33b63
+which slightly increases the usefulness of the static-routes option.
0f33b63
 .RE
0f33b63
 .PP
0f33b63
 .nf
0f33b63
diff -up dhcp-3.0.6/client/dhclient-script.8.manpages dhcp-3.0.6/client/dhclient-script.8
0f33b63
--- dhcp-3.0.6/client/dhclient-script.8.manpages	2005-09-28 15:17:08.000000000 -0400
0f33b63
+++ dhcp-3.0.6/client/dhclient-script.8	2007-09-26 15:22:12.000000000 -0400
0f33b63
@@ -47,7 +47,7 @@ customizations are needed, they should b
0f33b63
 exit hooks provided (see HOOKS for details).   These hooks will allow the
0f33b63
 user to override the default behaviour of the client in creating a
0f33b63
 .B /etc/resolv.conf
0f33b63
-file.
0f33b63
+file, and to handle DHCP options not handled by default.
0f33b63
 .PP
0f33b63
 No standard client script exists for some operating systems, even though
0f33b63
 the actual client may work, so a pioneering user may well need to create
0f33b63
@@ -91,6 +91,27 @@ present.   The
0f33b63
 .B ETCDIR/dhclient-exit-hooks
0f33b63
 script can modify the valid of exit_status to change the exit status
0f33b63
 of dhclient-script.
0f33b63
+.PP
0f33b63
+Immediately after dhclient brings an interface UP with a new IP address,
0f33b63
+subnet mask, and routes, in the REBOOT/BOUND states, it will check for the
0f33b63
+existence of an executable
0f33b63
+.B ETCDIR/dhclient-up-hooks
0f33b63
+script, and source it if found. This script can handle DHCP options in
0f33b63
+the environment that are not handled by default. A per-interface.
0f33b63
+.B ETCDIR/dhclient-${IF}-up-hooks
0f33b63
+script will override the generic script and be sourced when interface
0f33b63
+$IF has been brought up.
0f33b63
+.PP
0f33b63
+Immediately before dhclient brings an interface DOWN, removing its IP
0f33b63
+address, subnet mask, and routes, in the STOP/RELEASE  states, it will
0f33b63
+check for the existence of an executable
0f33b63
+.B ETCDIR/dhclient-down-hooks
0f33b63
+script, and source it if found. This script can handle DHCP options in
0f33b63
+the environment that are not handled by default. A per-interface
0f33b63
+.B ETCDIR/dhclient-${IF}-down-hooks
0f33b63
+script will override the generic script and be sourced when interface
0f33b63
+$IF is about to be brought down.
0f33b63
+
0f33b63
 .SH OPERATION
0f33b63
 When dhclient needs to invoke the client configuration script, it
0f33b63
 defines a set of variables in the environment, and then invokes
0f33b63
diff -up dhcp-3.0.6/client/dhclient.conf.5.manpages dhcp-3.0.6/client/dhclient.conf.5
0f33b63
--- dhcp-3.0.6/client/dhclient.conf.5.manpages	2007-05-01 16:42:55.000000000 -0400
0f33b63
+++ dhcp-3.0.6/client/dhclient.conf.5	2007-09-26 15:22:12.000000000 -0400
0f33b63
@@ -185,7 +185,8 @@ responding to the client send the client
0f33b63
 options.   Only the option names should be specified in the request
0f33b63
 statement - not option parameters.   By default, the DHCP server
0f33b63
 requests the subnet-mask, broadcast-address, time-offset, routers,
0f33b63
-domain-name, domain-name-servers and host-name options. 
0f33b63
+domain-name, domain-name-servers, host-name, nis-domain, nis-servers,
0f33b63
+and ntp-servers options.
0f33b63
 .PP
0f33b63
 In some cases, it may be desirable to send no parameter request list
0f33b63
 at all.   To do this, simply write the request statement but specify
0f33b63
@@ -581,6 +582,18 @@ database and will record the media type 
0f33b63
 Whenever the client tries to renew the lease, it will use that same
0f33b63
 media type.   The lease must expire before the client will go back to
0f33b63
 cycling through media types.
0f33b63
+.PP
0f33b63
+ \fBbootp-broadcast-always;\fR
0f33b63
+.PP
0f33b63
+The
0f33b63
+.B bootp-broadcast-always
0f33b63
+statement instructs dhclient to always set the bootp broadcast flag in
0f33b63
+request packets, so that servers will always broadcast replies.
0f33b63
+This is equivalent to supplying the dhclient -B argument, and has
0f33b63
+the same effect as specifying 'always-broadcast' in the server's dhcpd.conf.
0f33b63
+This option is provided as a Red Hat extension to enable dhclient to work
0f33b63
+on IBM zSeries z/OS Linux guests.
0f33b63
+.PP
0f33b63
 .SH SAMPLE
0f33b63
 The following configuration file is used on a laptop running NetBSD
0f33b63
 1.3.   The laptop has an IP alias of 192.5.5.213, and has one
c637bc5
diff -up dhcp-3.0.6/client/dhclient.8.manpages dhcp-3.0.6/client/dhclient.8
c637bc5
--- dhcp-3.0.6/client/dhclient.8.manpages	2007-05-01 16:42:55.000000000 -0400
0f33b63
+++ dhcp-3.0.6/client/dhclient.8	2007-09-26 15:22:12.000000000 -0400
c637bc5
@@ -82,6 +82,28 @@ relay
c637bc5
 .B -w
3b727ca
 ]
3b727ca
 [
3b727ca
+.B -I
3b727ca
+.I dhcp-client-identifier
3b727ca
+]
3b727ca
+[
3b727ca
+.B -H
3b727ca
+.I host-name
3b727ca
+.R |
3b727ca
+.B -F fqdn.fqdn
3b727ca
+]
3b727ca
+[
3b727ca
+.B -V
3b727ca
+.I vendor-class-identifier
3b727ca
+]
3b727ca
+[
3b727ca
+.B -R
3b727ca
+.I request option list
3b727ca
+]
3b727ca
+[
c637bc5
+.B -T
3b727ca
+.I timeout
3b727ca
+]
3b727ca
+[
3b727ca
 .I if0
3b727ca
 [
3b727ca
 .I ...ifN
c637bc5
@@ -265,6 +287,110 @@ than waiting until it has acquired an IP
c637bc5
 supplying the
c637bc5
 .B -nw
c637bc5
 flag.
3b727ca
+.PP
c637bc5
+The -I <id> argument allows you to specify the dhcp-client-identifier string,
c637bc5
+<id>, to be sent to the dhcp server on the command line.  It is equivalent to
c637bc5
+the top level dhclient.conf statement:
3b727ca
+.br
3b727ca
+ \fBsend dhcp-client-identifier "<id>";\fR
3b727ca
+.br
c637bc5
+The -I <id> command line option will override any top level dhclient.conf
3b727ca
+ 'send dhcp-client-identifier' statement, but more specific per-interface
3b727ca
+ 'interface "X" { send dhcp-client-identifier...; }' statements in dhclient.conf
3b727ca
+will override the -I <id> command line option for interface "X".
3b727ca
+This option is provided as a Red Hat extension to enable dhclient to work
3b727ca
+on IBM zSeries z/OS Linux guests.
3b727ca
+.PP
3b727ca
+The -B option instructs dhclient to set the bootp broadcast flag in request
3b727ca
+packets, so that servers will always broadcast replies. This is equivalent
3b727ca
+to specifying the 'bootp-broadcast-always' option in dhclient.conf, and has
3b727ca
+the same effect as specifying 'always-broadcast' in the server's dhcpd.conf.
3b727ca
+This option is provided as a Red Hat extension to enable dhclient to work
3b727ca
+on IBM zSeries z/OS Linux guests.
c637bc5
+.PP
3b727ca
+The -H <host-name> option allows you to specify the DHCP host-name option
3b727ca
+to send to the server on the dhclient command line. It is equivalent to the
3b727ca
+top level dhclient.conf statement:
3b727ca
+.br
3b727ca
+\f send host-name "<host-name>";\fR
3b727ca
+.br
c637bc5
+The -H <host-name> option  will override any top level dhclient.conf
c637bc5
+ 'send host-name' statement, but more specific per-interface
3b727ca
+ 'interface "X" { send host-name...;' statements in dhclient.conf
3b727ca
+will override the -H <host-name> command line option for interface "X".
3b727ca
+The host-name option only specifies the client's host name prefix, to which
3b727ca
+the server will append the 'ddns-domainname' or 'domain-name' options, if any,
3b727ca
+to derive the fully qualified domain name of the client host.
3b727ca
+The -H <host-name> option cannot be used with the -F <fqdn.fqdn> option.
3b727ca
+Only one -H <host-name> option may be specified.
3b727ca
+The -H <host-name> option is provided as a Red Hat extension to simplify
3b727ca
+configuration of clients of DHCP servers that require the host-name option
c637bc5
+to be sent (eg. some modern cable modems), and for dynamic DNS updates (DDNS).
3b727ca
+.PP
3b727ca
+The -F <fqdn.fqdn> option allows you to specify the DHCP fqdn.fqdn option
3b727ca
+to send to the server on the dhclient command line. It is equivalent to the
3b727ca
+top level dhclient.conf statement:
3b727ca
+.br
3b727ca
+\f send fqdn.fqdn "<domain-name>";\fR
3b727ca
+.br
c637bc5
+The -F <fqdn.fqdn> option  will override any top level dhclient.conf
c637bc5
+ 'send fqdn.fqdn' statement, but more specific per-interface
3b727ca
+ 'interface "X" { send fqdn.fqdn...;' statements in dhclient.conf
3b727ca
+will override the -F <fqdn.fqdn> command line option for interface "X".
3b727ca
+This option cannot be used with the -H <host-name> option.
3b727ca
+The DHCP fqdn.fqdn option must specify the complete domain name of the client
3b727ca
+host, which the server may use for dynamic DNS updates.
3b727ca
+Only one -F <fqdn.fqdn> option may be specified.
3b727ca
+The -F <fqdn.fqdn> option is provided as a Red Hat extension to simplify
c637bc5
+configuration of DDNS.
3b727ca
+.PP
c637bc5
+The -T <timeout> option allows you to specify the time after which
3b727ca
+the dhclient will decide that no DHCP servers can be contacted when
c637bc5
+no responses have been received. It is equivalent to the
3b727ca
+.br
3b727ca
+\f timeout <integer>;\fR
3b727ca
+.br
3b727ca
+dhclient.conf statement, and will override any such statements in dhclient.conf.
3b727ca
+.br
3b727ca
+This option is provided as a Red Hat extension.
3b727ca
+.PP
c637bc5
+The -V <vendor-class-identifier> option allows you to specify the DHCP
c637bc5
+vendor-class-identifier option to send to the server on the dhclient command
c637bc5
+line.  It is equivalent to the top level dhclient.conf statement:
3b727ca
+.br
3b727ca
+\f send vendor-class-identifier "<vendor-class-identifier>";\fR
3b727ca
+.br
c637bc5
+The -V <vendor-class-identifier> option  will override any top level
c637bc5
+dhclient.conf
c637bc5
+ 'send vendor-class-identifier' statement, but more specific per-interface
3b727ca
+ 'interface "X" { send vendor-class-identifier...;' statements in dhclient.conf
c637bc5
+will override the -V <vendor-class-identifier> command line option for
c637bc5
+interface "X".
c637bc5
+The -V <vendor-class-identifier> option is provided as a Red Hat extension to
c637bc5
+simplify configuration of clients of DHCP servers that require the
c637bc5
+vendor-class-identifier option to be sent.
3b727ca
+.PP
c637bc5
+The -R <request option list> option allows you to specify the list of options
c637bc5
+the client is to request from the server on the dhclient command line.
3b727ca
+The option list must be a single string, consisting of option names separated
3b727ca
+by at least one comma and optional space characters. The default option list
c637bc5
+is:
3b727ca
+.br
c637bc5
+    subnet-mask, broadcast-address, time-offset, routers,
3b727ca
+.br
c637bc5
+    domain-name, domain-name-servers, host-name, nis-domain,
3b727ca
+.br
3b727ca
+    nis-servers, ntp-servers
3b727ca
+.br
c637bc5
+You can specify a different list of options to request with the -R <option list>
c637bc5
+argument.  This is equivalent to the dhclient.conf statement:
3b727ca
+.br
3b727ca
+\f    request <option list> ;\fR
3b727ca
+.br
c637bc5
+The -R argument is provided as a Red Hat extension to ISC dhclient to
c637bc5
+facilitate requesting a list of options from the server different to the
c637bc5
+default.
3b727ca
+.PP
3b727ca
 .SH CONFIGURATION
3b727ca
 The syntax of the dhclient.conf(5) file is discussed separately.
3b727ca
 .SH OMAPI