diff -up dhcp-4.1.0/client/dhclient.8.man dhcp-4.1.0/client/dhclient.8 --- dhcp-4.1.0/client/dhclient.8.man 2008-11-20 04:55:14.000000000 -1000 +++ dhcp-4.1.0/client/dhclient.8 2009-01-06 11:51:30.000000000 -1000 @@ -111,6 +111,33 @@ relay .B -w ] [ +.B -B +] +[ +.B -I +.I dhcp-client-identifier +] +[ +.B -H +.I host-name +] +[ +.B -F +.I fqdn.fqdn +] +[ +.B -V +.I vendor-class-identifier +] +[ +.B -R +.I request-option-list +] +[ +.B -timeout +.I timeout +] +[ .B -v ] [ @@ -138,32 +165,6 @@ important details about the network to w the location of a default router, the location of a name server, and so on. .PP -If given the -4 command line argument (default), dhclient will use the -DHCPv4 protocol to obtain an IPv4 address and configuration parameters. -.PP -If given the -6 command line argument, dhclient will use the DHCPv6 -protocol to obtain whatever IPv6 addresses are available along with -configuration parameters. But with -.B -S -it uses Information-request to get only (i.e., without address) -stateless configuration parameters. -.PP -The default DHCPv6 behavior is modified too with -.B -T -which asks for IPv6 temporary addresses, one set per -.B -T -flag. -.B -P -enables the IPv6 prefix delegation. -As temporary addresses or prefix delegation disables the normal -address query, -.B -N -restores it. Note it is not recommended to mix queries of different types -together, or even to share the lease file between them. -.PP -If given the --version command line argument, dhclient will print its -version number and exit. -.PP On startup, dhclient reads the .IR dhclient.conf for configuration instructions. It then gets a list of all the @@ -217,141 +218,259 @@ file. If interfaces are specified in t only configure interfaces that are either specified in the configuration file or on the command line, and will ignore all other interfaces. -.PP -If the DHCP client should listen and transmit on a port other than the -standard (port 68), the -.B -p -flag may used. It should be followed by the udp port number that -dhclient should use. This is mostly useful for debugging purposes. -If a different port is specified for the client to listen on and -transmit on, the client will also use a different destination port - -one less than the specified port. -.PP -The DHCP client normally transmits any protocol messages it sends -before acquiring an IP address to, 255.255.255.255, the IP limited -broadcast address. For debugging purposes, it may be useful to have -the server transmit these messages to some other address. This can -be specified with the -.B -s -flag, followed by the IP address or domain name of the destination. -This feature is not supported by DHCPv6. -.PP -For testing purposes, the giaddr field of all packets that the client -sends can be set using the -.B -g -flag, followed by the IP address to send. This is only useful for testing, -and should not be expected to work in any consistent or useful way. -.PP -The DHCP client will normally run in the foreground until it has -configured an interface, and then will revert to running in the -background. To run force dhclient to always run as a foreground -process, the -.B -d -flag should be specified. This is useful when running the client -under a debugger, or when running it out of inittab on System V -systems. -.PP -The dhclient daemon creates its own environment when executing the -dhclient-script to do the grunt work of interface configuration. -To define extra environment variables and their values, use the -.B -e -flag, followed by the environment variable name and value assignment, -just as one would assign a variable in a shell. Eg: -.B -e -.I IF_METRIC=1 -.PP -The client normally prints no output during its startup sequence. It -can be made to emit verbose messages displaying the startup sequence events -until it has acquired an address by supplying the -.B -v -command line argument. In either case, the client logs messages using -the -.B syslog (3) -facility. A -.B -q -command line argument is provided for backwards compatibility, but since -dhclient is quiet by default, it has no effect. -.PP -The client normally doesn't release the current lease as it is not -required by the DHCP protocol. Some cable ISPs require their clients -to notify the server if they wish to release an assigned IP address. -The -.B -r -flag explicitly releases the current lease, and once the lease has been -released, the client exits. -.PP +.SH OPTIONS +.TP +.BI \-4 +Use the DHCPv4 protocol to obtain an IPv4 address and configuration +parameters (default). + +.TP +.BI \-6 +Use the DHCPv6 protocol to obtain whatever IPv6 addresses are available +along with configuration parameters. The functionality of DHCPv6 mode +may be modified with the +.BI \-S +, +.BI \-T +, and +.BI \-N +options. + +.TP +.BI \-S +Perform an information-only request over DHCPv6 to get stateless +configuration parameters. It is not recommended to combine this option +with the +.BI \-N +, +.BI \-P +, or +.BI \-T +options or to share lease files between different modes of operation. Only +valid with the +.BI \-6 +option. + +.TP +.BI \-N +Perform a normal (IA_NA) address query over DHCPv6. It is not recommended +to combine this option with the +.BI \-P +, +.BI \-S +, or +.BI \-T +options or to share lease files between different modes of operation. Only +valid with the +.BI \-6 +option. + +.TP +.BI \-T +Perform a temporary (IA_TA) address query over DHCPv6 (disables normal address +query). It is not recommended to combine this option with the +.BI \-N +, +.BI \-P +, or +.BI \-S +options or to share lease files between different modes of operation. Only +valid with the +.BI \-6 +option. + +.TP +.BI \-P +Enable IPv6 prefix delegation (disables normal address query). It is not +not recommended to combine this option with the +.BI \-N +, +.BI \-S +, or +.BI \-T +options or to share lease files between different modes of operation. Only +valid with the +.BI \-6 +option. + +.TP +.BI \-p\ +The UDP port number the DHCP client should listen and transmit on. If +unspecified, +.B dhclient +uses the default port 68. This option is mostly useful for debugging +purposes. If a different port is specified for the client to listen and +transmit on, the client will also use a different destination port - one +less than the specified port. + +.TP +.BI \-d +Force +.B dhclient +to run as a foreground process. This is useful when running the client +under a debugger, or when running it out of inittab on System V systems. + +.TP +.BI \-e\ VAR=value +Define additional environment variables for the environment where +dhclient-script executes. You may specify multiplate +.B \-e +options on the command line. For example: +.B \-e IF_METRIC=1 + +.TP +.BI \-q +Suppress all terminal and log output except error messages. + +.TP +.BI \-1 +Try once to get a lease. One failure, exit with code 2. + +.TP +.BI \-r +Tell +.B dhclient +to release the current lease it has from the server. This is not required +by the DHCP protocol, but some ISPs require their clients to notify the +server if they wish to release an assigned IP address. + +.TP +.BI \-lf\ +Path to the lease database file. If unspecified, the default +.B DBDIR/dhclient.leases +is used. + +.TP +.BI \-pf\ +Path to the process ID file. If unspecified, the default +.B RUNDIR/dhclient.pid +is used. + +.TP +.BI \-cf\ +Path to the client configuration file. If unspecified, the default +.B ETCDIR/dhclient.conf +is used. + +.TP +.BI \-sf\ +Path to the network configuration script invoked by +.B dhclient +when it gets a lease. If unspecified, the default +.B /sbin/dhclient-script +is used. + +.TP +.BI \-s\ +Specifiy the server IP address or fully qualified domain name to transmit +DHCP protocol messages to. Normally, +.B dhclient +transmits these messages to 255.255.255.255 (the IP limited broadcast +address). Overriding this is mostly useful for debugging purposes. + +.TP +.BI \-g\ +Only for debugging. Set the giaddr field of all packets the client +sends to the IP address specified. This should not be expected to work +in any consistent or useful way. + +.TP +.BI \-n +Do not configure any interfaces. Most useful combined with the +.B -w +option. + +.TP +.BI \-nw +Become a daemon process immediately (nowait) rather than waiting until an IP +address has been acquired. + +.TP +.BI \-w +Keep running even if no network interfaces are found. The +.B omshell +program can be used to notify the client when a network interface has been +added or removed so it can attempt to configure an IP address on that +interface. + +.TP +.BI \-B +Set the BOOTP broadcast flag in request packets so servers will always +broadcast replies. + +.TP +.BI \-I\ +Specify the dhcp-client-identifier option to send to the DHCP server. + +.TP +.BI \-H\ +Specify the host-name option to send to the DHCP server. The host-name +string only contains the client's hostname prefix, to which the server will +append the ddns-domainname or domain-name options, if any, to derive the +fully qualified domain name of the client. The +.B -H +option cannot be used with the +.B -F +option. + +.TP +.BI \-F\ +Specify the fqdn.fqdn option to send to the DHCP server. This option cannot +be used with the +.B -H +option. The fqdn.fqdn option must specify the complete domain name of the +client host, which the server may use for dynamic DNS updates. + +.TP +.BI \-V\ +Specify the vendor-class-identifier option to send to the DHCP server. + +.TP +.BI \-R\