HP-UX Reference (11i v3 07/02) - 1M System Administration Commands A-M (vol 3)

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_identifier 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 wildcards
can be specified. If a domain_name is specified, it will be appended to the hostname. The max-
imum 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 dura-
tion using the parameters lease-time and requested-IP-address. Use Internet address dot nota-
tion (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).
152 Hewlett-Packard Company − 1 − HP-UX 11i Version 3: February 2007