HP-UX Reference (11i v1 05/09) - 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 host-
name. 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 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 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 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
HP-UX 11i Version 1: September 2005 − 1 − Hewlett-Packard Company Section 1M−−173