.\" $Header: /cvsroot/dhcp-agent/dhcp-agent/man/dhcp-client.1.in,v 1.3 2003/07/06 17:28:22 actmodern Exp $ .\" .\" Copyright 2003 Thamer Alharbash .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" .\" 1. Redistributions of source code must retain the above copyright .\" notice, this list of conditions and the following disclaimer. .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in .\" the documentation and/or other materials provided with the .\" distribution. .\" 3. The names of the authors may not be used to endorse or promote .\" products derived from this software without specific prior .\" written permission. .\" .\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR .\" IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED .\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. .\" .TH DHCP-CLIENT "8" "May 2003" .SH NAME dhcp-client \- a dhcp client daemon .SH SYNOPSIS .B dhcp-client [ .B -ackpwvs ] [ .B -i interface ] [ .B -l level ] [ .B -m mac address ] .SH DESCRIPTION .PP 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. .PP 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 .B @-infodir-@ and optionally as HTML pages in .B @-dhcpdocdir-@ The accompanying manual is more expository than the man pages provided. The man pages should be used only as a quick reference. .SH OPTIONS .TP .B -h Print out usage. .TP .B -v Print out version information .TP .B -a Always run in the foreground and do not go into the background. .TP .B -c Clear the cache. This is useful in case a stale cache is left behind by an earlier invocation. .TP .B -k 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. .TP .B -p 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. .TP .B -w 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. .TP .B -s Print out status information on the most recent lease acquired by the client. .TP .B -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. .TP .B -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. .TP .B -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. .SH USAGE .PP 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 .B -i option. .SH EXIT STATUS Will exit with a non-zero value if an error occured. .SH FILES .TP .B @-dhcplocalstate_clientdir-@ directory where the lease cache is kept. .TP .B @-dhcpsysconf_clientdir-@ directory where the configuration files are kept. .TP .B @-infodir-@ directory where the GNU info manual is kept. .TP .B @-dhcpdocdir-@ directory where the optional HTML documentation is kept. .SH AUTHOR .TP Thamer Alharbash
