dhcptools.1m (2010 09)

d
dhcptools(1M) dhcptools(1M)
NAME
dhcptools - command line tool for DHCP elements of bootpd
SYNOPSIS
dhcptools -d
dhcptools -h fip=first_IP_address
no=number_of_entries_to_generate
sm=subnet_mask
hn=hostname_template [
dn=domain_name ]
dhcptools -p ht=hardware_type
ha=hardware_address
sn=subnet_identifier [
lt=lease_time ]
[
rip= requested_IP_address]
dhcptools -P ci=client_identifier
sn=subnet_identifier [
lt=lease_time ]
[
rip=requested_IP_address]
dhcptools -C cl=class_identi fier
sn=subnet_identifier [lt=
lease_time ]
[
rip=requested_IP_address]
dhcptools -r ip=IP_address ht=hardware_type
ha=hardware_address
dhcptools -R ip=IP_address ci=client_identifier
dhcptools -t [ct=count ]
dhcptools -v [bt=bootptabfile][dt=dhcptabfile]
DESCRIPTION
dhcptools is a command line tool that provides access to DHCP-related options for the bootpd server.
The options provide control for dumping internal data structures, generating a hosts file, previewing
client address assignment, reclaiming unused addresses, tracing packets, and validating configuration
files.
Options
dhcptools supports the following options:
-d Dump internal bootpd data to output files. The dump output files are
/tmp/dhcp.dump.bootptab
, /tmp/dhcp.dump.dhcptab, and
/tmp/dhcp.dump.other
. The first file reports fixed address clients known to the currently
active
bootpd server. The second file reports bootpd global and group configuration. The
third file reports miscellaneous
bootpd internal data.
-h Generate a hosts file in /etc/hosts format; see hosts(4). The output file is
/tmp/dhcphosts. The file can be incorporated into a name database in advance of
bootpd
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 bootpd
server uses
gethostbyaddr (3N) to find the host name associated with a particular IP address. Each host
entry in
dhcphosts contains 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
hostname_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 per-
mitted 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 sequentially from the range [0-9].
A ? means to use a letter selected sequentially from the range [a-z]. A maximum of 3 wild-
cards can be specified. If a domain_name is specified, it will be appended to the hostname.
The maximum number_of_entries_to_generate is 1000.
-p Preview a client’s address assignment based on current conditions for the bootpd server. The
output is written to stdout. The subnet-identifier tells bootpd 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.
-P Preview a client’s address assignment based on current conditions for the bootpd server.
This option is the same as -p except that the client is identified by a unique client-identifer.
See bootpd (1M).
-C Preview a client’s address assignment based on current conditions of the bootpd server. This
option is the same as -p except that the class identifier is used to identify the device group
from which the client is requesting an IP address. See bootpd (1M).
HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1