dhcptools(1M)

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.

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 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.

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.

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).

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).

Reclaim a client's IP address for re-use by the bootpd server. This option is intended for limited use by the bootpd administrator to return an allocated but unused IP address to a DHCP allocation pool. The option may be useful to clear the bootpd database of old entries (for example, for clients retired from service while holding an unexpired 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 bootpd database file.

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

Establish packet tracing for bootpd. This will trace the inbound and outbound BOOTP/DHCP packets for the local bootpd server. The output file is /tmp/dhcptrace. The packet trace count can be a value from 0 to 100. To query the current count, use dhcptools -t. To turn off packet tracing use dhcptools -t ct=0.

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

Only one of the -d, -h, -t, -p, -P, -r, -R, or -v options is allowed per dhcptools command.