[Dhcp-agent-commits] CVS: dhcp-agent dhcpclient.1,1.8,1.9

[Thamer Al-H. <act...@us...>]

Update of /cvsroot/dhcp-agent/dhcp-agent
In directory usw-pr-cvs1:/tmp/cvs-serv27505

Modified Files:
	dhcpclient.1 
Log Message:
new (better) manpage; thanks Brian J. Kifiak

Index: dhcpclient.1
===================================================================
RCS file: /cvsroot/dhcp-agent/dhcp-agent/dhcpclient.1,v
retrieving revision 1.8
retrieving revision 1.9
diff -C2 -d -r1.8 -r1.9
*** dhcpclient.1	11 Feb 2002 18:02:24 -0000	1.8
--- dhcpclient.1	7 Jun 2002 13:14:47 -0000	1.9
***************
*** 1,71 ****
  .Dd January, 29, 2001
! .Dt DHCPCLIENT
  .Sh NAME 
  .Nm dhcpclient
! -- DHCP Client.
  .Sh SYNOPSIS
! .Nm dhcpclient
! .Op -avckw
! .Op -k
! .Op Ar -d working directory
! .Op Ar -i interface name
! .Op Ar -m fake mac source address
! .Op Ar -l verbosity_level
  .Sh DESCRIPTION
! .I
! dhcpclient is a DHCP client daemon. It will start up in the
! foreground until it initializes its interface, and then go into the
! background and renew its lease when it needs to. You may safely run
! more than one dhcpclient per host since it stores all its data in
! control files named after the interface it is configuring. It is not
! safe to run more than one dhcpclient per interface. Currently only
! the basic networking DHCP options are handled. The interfaces IP
! address, the routing table, and the domain name system are setup.
! .Sh OPTIONS
! .Bl -tag
! .It Op -p
! Run in promiscious mode (implicit with -m flag). You should only
! use this option if the system you are using dhcpclient on is
! sufficiently broken that it needs promiscious mode to receive
! packets with libpcap.
! .It Op Ar -i interface name
! Specifies a the name of an interface dhcpsniff will use. otherwise
! dhcpsniff will let pcap decide. Default value is "eth0"
! .It Op Ar -d working directory
! By default dhcpclient will use "/etc/dhcpclient" to store its
! control files. This option allows another directory to be used. Be
! warned that the directory must be only readable and writeable by
! root to ensure security.
! .It Op -a
! Run in foreground always.
! .It Op -k
! Kill current dhcpclient on specified interface.
! .It Op -v
! Print version.
! .It Op -w
! Wake current dhcpclient on specificed interface. This forces a renew.
! .It Op -c
! Clear cache. Should be used if client crashes and leaves corrupt
! cache.
! .It Op Ar -m fake mac address
! Use a fake mac source address. Useful only for diagnostics where
! want to see if a specific lease based on a mac address is accessible.
! .It Op Ar -l verbosity level
! Verbosity level can be set to the following integers:
! .Bl -tag
! .It 0 No output
! .It 1 Only error messages are outputed.
! .It 2 Normal output; errors and info messages.
! .It 3 Warning level. Output warnings along with error and info messages.
! .It 4 Debug level. Lots of diagnostic output. All messages.
! .El
! .El 
! .Sh BUGS
  .Pp
! dhcpclient is still in alpha mode.
  .Pp
  .Sh SEE ALSO
! .Xr dhcpsniff 1 
  .Sh AUTHORS
! Thamer Al-Harbash
  .Aq tm...@wh...
--- 1,111 ----
+ .\" $Header$
  .Dd January, 29, 2001
! .Dt DHCPCLIENT 1
  .Sh NAME 
  .Nm dhcpclient
! .Nd DHCP (Dynamic Host Configuration Protocol) Client
  .Sh SYNOPSIS
! .Nm
! .Op Fl achkpvw
! .Op Fl d Ar directory
! .Op Fl i Ar interface
! .Op Fl l Ar level
! .Op Fl m Ar mac_addr
  .Sh DESCRIPTION
! .Nm
! is a DHCP client daemon.
! .Nm
! currently it only configures basic networking: the interface's IP address; the
! routing table; and the domain name system using the DHCP-provided settings.
  .Pp
! By default,
! .Nm
! runs in the foreground until it initializes its interface, then forks
! into the background, renewing its lease as needed. 
! .Pp
! More than one
! .Nm
! may safely be run per host, but it is not safe to run more than one
! .Nm
! per interface.
! A single
! .Nm
! deals with a single interface.
  .Pp
+ The options are as follows:
+ .Bl -tag -width Ds
+ .It Fl a
+ Always run in the foreground.
+ .It Fl c
+ Clear cache.
+ Useful if 
+ .Nm
+ crashes and leaves a corrupt cache.
+ .It Fl d Ar directory
+ Control file directory.
+ Default is
+ .Pa /etc/dhcpclient .
+ The directory is created readable and writable to root (the usual
+ user of 
+ .Nm
+ ) to ensure security.
+ .It Fl h
+ Help.
+ .It Fl i Ar interface
+ Perform DHCP query on
+ .Ar interface ,
+ otherwise it will scan the interface table and use the first
+ downed ethernet interface it finds, or the first ethernet
+ interface it finds.
+ .It Fl k
+ Kill
+ .Nm dhcpclient .
+ .It Fl l Ar level
+ Set the verbosity level to one of the following:
+ .Bl -tag -width "l 0 " -compact
+ .It Fl l Ar 0
+ Don't generate messages.
+ .It Fl l Ar 1
+ Generate messages only for errors.
+ .It Fl l Ar 2
+ Generate messages for errors and misc. info (normal).
+ .It Fl l Ar 3
+ Generate messages for errors, warnings, and misc. info.
+ .It Fl l Ar 4
+ Generate messages for all conditions, plus diagnostics.
+ .El
+ .It Fl m Ar mac_addr
+ Send DHCP query using
+ .Ar mac_addr .
+ Useful for diagnostics when testing response based a MAC address.
+ Implies
+ .Fl p .
+ .It Fl p
+ Put the interface into promiscuous mode.
+ Should only be used if the system is sufficiently broken that
+ .Xr pcap 3
+ needs promiscuous mode to receive packets.
+ .It Fl v
+ Version.
+ .It Fl w
+ Wake 
+ .Nm dhcpclient ,
+ forcing a renew.
+ .El
+ .Sh BUGS
+ .Nm
+ is still in alpha mode.
+ .Sh FILES
+ .Bl -tag -width "/etc/dhcpclient" -compact
+ .It Pa /etc/dhcpclient
+ Control file directory
+ .El
  .Sh SEE ALSO
! .Xr dhcpsniff 1 ,
! .Xr dnet 3 ,
! .Xr pcap 3
  .Sh AUTHORS
! .An Thamer Al-Harbash
  .Aq tm...@wh...
+ .An Brian J. Kifiak 
+ .Aq bk...@rt...