dhcptools man page on HP-UX

Man page or keyword search:  
man Server   10987 pages
apropos Keyword Search (all sections)
Output format
HP-UX logo
[printable version]

dhcptools(1M)							 dhcptools(1M)

NAME
       dhcptools - command line tool for DHCP elements of bootpd

SYNOPSIS

       []

       [] [requested_IP_address]

       [] []

       [] []

       []

       [] []

DESCRIPTION
       is a command line tool that provides access to DHCP-related options for
       the server.  The options provide	 control  for  dumping	internal  data
       structures,  generating a hosts file, previewing client address assign‐
       ment, reclaiming unused addresses, tracing packets, and validating con‐
       figuration files.

   Options
       supports the following options:

	      Dump internal
		     data  to output files.  The dump output files are and The
		     first file reports fixed address  clients	known  to  the
		     currently	active server.	The second file reports global
		     and group configuration.  The third file reports  miscel‐
		     laneous internal data.

	      Generate a hosts file in
		     format; see hosts(4).  The output file is The file can be
		     incorporated into a name database in  advance  of	server
		     activation	 so that the server can automatically allocate
		     a host name along with an IP address to  a	 DHCP  client.
		     For  IP  address  allocation  to DHCP clients, the server
		     uses gethostbyaddr(3N) to find the host  name  associated
		     with  a  particular  IP address.  Each host entry in con‐
		     tains an IP address  followed  by	a  hostname.   The  IP
		     address  of  the  first  entry  is first_IP_address.  The
		     hostname of the first entry is  derived  from  the	 host‐
		     name_template.   Each  subsequent	host  entry contains a
		     unique  IP	 address  and  hostname	  derived   from   the
		     first_IP_address,	 subnet_mask,  and  hostname_template.
		     The wildcards permitted in the  hostname_template	are  A
		     means  to	use a character selected sequentially from the
		     range [a-z,0-9].  A means to use a digit selected sequen‐
		     tially  from  the	range  [0-9].  A means to use a letter
		     selected sequentially from the range [a-z].  A maximum of
		     3 wildcards can be specified.  If a domain_name is speci‐
		     fied, it will be appended to the hostname.	  The  maximum
		     number_of_entries_to_generate is 1000.

	      Preview a client's address assignment based on current
		     conditions for the server.	 The output is written to std‐
		     out.  The subnet-identifier tells the  subnet  for	 which
		     the  client is requesting an IP address.  Optionally, the
		     user may request a specific IP address and lease duration
		     using the parameters lease-time and requested-IP-address.
		     Use Internet address dot notation (see inet(3N)  for  the
		     IP	 address  and  an  integer  number  of seconds for the
		     lease-time.

	      Preview a client's address assignment based on current
		     conditions for the server.	 This option is	 the  same  as
		     except  that the client is identified by a unique client-
		     identifer.	 See bootpd(1M).

	      Preview a client's address assignment based on current
		     conditions of the server.	This option  is	 the  same  as
		     except  that the class identifier is used to identify the
		     device group from which the client is  requesting	an  IP
		     address.  See bootpd(1M).

	      Reclaim a client's IP address for re-use by the
		     server.   This  option is intended for limited use by the
		     administrator  to	return	an  allocated  but  unused  IP
		     address  to  a  DHCP  allocation pool.  The option may be
		     useful to clear the database of old entries (for example,
		     for  clients  retired from service while holding an unex‐
		     pired IP address lease).  Do not reclaim an address  that
		     belongs  to  an  active  client.	See  bootpd(1M).   The
		     IP_address, hardware_address, and	hardware_type  can  be
		     obtained from the database file.

	      Reclaim a client's IP address for re-use by the
		     server.   This  option  is	 the  same  as except that the
		     client is identified  by  its  unique  client_identifier.
		     See bootpd(1M).  The IP_address and matching client_iden‐
		     tifier can be obtained from the database file.

	      Establish packet tracing for
		     This will trace the inbound and outbound BOOTP/DHCP pack‐
		     ets  for the local server.	 The output file is The packet
		     trace count can be a value from 0 to 100.	To  query  the
		     current count, use To turn off packet tracing use

	      Validate
		     configuration  files.   The  default  configuration files
		     that will be validated are and  When  a  bootptabfile  or
		     dhpctabfile  is specified, the full pathname is required.
		     The output file for validate is

	      Only one of the or options is allowed per command.

RETURN VALUE
       returns zero upon successful completion	or  non-zero  if  the  command
       failed, in which case an explanation is written to standard error.

EXAMPLES
       Dump the active server's internal data to the dump output files:

       Generate a file with 10 entries:

       Query the active daemon for the the current packet trace count:

       Set the count to 10 packets:

       Preview two clients' address assignments by hardware address:

       To preview a client's address assignment by client identifier, a unique
       client identifier value is needed.  This information  can  be  obtained
       for  actual  DHCP  clients  (provided they support a client identifier)
       from the manufacturer's documentation.  See bootpd(1M) for more	infor‐
       mation  about  the  client identifier.  Assuming that is a valid client
       identifier, the preview command is:

       To reclaim an IP address by hardware address:

       The parameter values were obtained from this sample entry in the dhcpdb
       file:

       To  reclaim  an IP address by client identifier (see earlier example of
       preview by client identifier):

       To validate a bootptab and dhcptab file:

WARNINGS
       The operations of dump, packet trace, preview, and  reclaim  depend  on
       communication with the local server.  If the server is not running, you
       may encounter an error.

AUTHOR
       was developed by HP.

FILES
       Default			file for validate

       Default			file for validate

       Dump output file

       Dump output file

       Dump output file

       FIFO file for		to communication

       FIFO file for		to communication

       FIFO file for		to communication

       Hostgen output file in	format

       Packet trace output file

       Validate output file

       Library file

SEE ALSO
       bootpd(1M), bootpquery(1M).

       DARPA Internet Request For Comments RFC1533, RFC1534, RFC1541, RFC1542,
       Assigned Numbers.

								 dhcptools(1M)
[top]

List of man pages available for HP-UX

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net