Section: Misc. Reference Manual Pages (8)
Updated: May 2003



dhcp-client - a dhcp client daemon  


dhcp-client [ -ackpwv ] [ -i interface ] [ -l level ] [ -m mac address ]  


dhcp-client is a highly configurable and extendable DHCP client. Out of the box it has been built to start up and perform DHCP for a basic network setup with minimal fuss.

dhcp-client is part of the dhcp-agent package. You should have received a complete manual in texi format which could have been installed as info pages in /usr/local/info or and optionally as HTML pages in /usr/local/doc/dhcp-agent The accompanying manual is more expository than the man pages provided. The man pages should be used only as a quick reference.  


Print out usage.
Print out version information
Always run in the foreground and do not go into the background.
Clear the cache. This is useful in case a stale cache is left behind by an earlier invocation.
Kill a dhcp-client instance. Coupled with the -i option this will kill a specific instance of dhcp-client. Otherwise the first dhcp-client found on an active ethernet interface is terminated.
Forces dhcp-client to use promiscious mode. This is only useful on systems which are sufficiently broken that require promiscious mode to receive broadcast messages.
Wake a dhcp-client instance. Coupled with the -i option this will wake up a client on a specified interface and cause it to either rebind, or renew earlier depending on which timer is next. Use this to force the client to reacquire a lease.
Print out status information on the most recent lease acquired by the client.
-i interface
Force dhcp-client to use the interface specified. This is useful to make sure dhcp-client uses a specific interface if the host is multi-homed.
-l level
Generate messages at the level specified. The level should be an integer between 0 - 4. The levels are no messages, error messages, info messages (default), warnings, diagnostic-messages, respectively. Each level includes all messages below it. The default is info messages which also include error messages.
-m mac address
Fake a mac address during the DHCP operation. This will only affect the DHCP operations and no others. This is useful for debugging a DHCP server that is not behaving itself.


On invocation dhcp-client will look for an ethernet interface which is not up and use the first one it finds to transmit DHCP discovery messages on. It will expect to be able to reach a DHCP server. You can force dhcp-client to pick an interface with the -i option.  


Will exit with a non-zero value if an error occured.  


directory where the lease cache is kept.
directory where the configuration files are kept.
directory where the GNU info manual is kept.
directory where the optional HTML documentation is kept.


Thamer Alharbash <tmh@whitefang.com>




This document was created by man2html, using the manual pages.
Time: 02:59:51 GMT, June 28, 2003