dhcp-client.1.in

this is sample about DHCP-agent

.\" $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 <[e-mail]>
.\" 
.\" 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 <[e-mail]>