DHCP-CLIENT
Section: Misc. Reference Manual Pages (8)
Updated: May 2003
NAME
dhcp-client - a dhcp client daemon
SYNOPSIS
dhcp-client
[
-ackpwv
]
[
-i interface
]
[
-l level
]
[
-m mac address
]
DESCRIPTION
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.
OPTIONS
- -h
-
Print out usage.
- -v
-
Print out version information
- -a
-
Always run in the foreground and do not go into the background.
- -c
-
Clear the cache. This is useful in case a stale cache is left
behind by an earlier invocation.
- -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.
- -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.
- -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.
- -s
-
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.
USAGE
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.
EXIT STATUS
Will exit with a non-zero value if an error occured.
FILES
- /usr/local/var/dhcp-agent/dhcp-client
-
directory where the lease cache is kept.
- /usr/local/etc/dhcp-agent/dhcp-client
-
directory where the configuration files are kept.
- /usr/local/info
-
directory where the GNU info manual is kept.
- /usr/local/doc/dhcp-agent
-
directory where the optional HTML documentation is kept.
AUTHOR
- Thamer Alharbash <tmh@whitefang.com>
-
Index
- NAME
-
- SYNOPSIS
-
- DESCRIPTION
-
- OPTIONS
-
- USAGE
-
- EXIT STATUS
-
- FILES
-
- AUTHOR
-
This document was created by
man2html,
using the manual pages.
Time: 02:59:51 GMT, June 28, 2003