dhcpinfo [-c] [-i interface] [-n limit] [-v 4|6] code
dhcpinfo [-c] [-i interface] [-n limit] [-v 4|6] identifier
The dhcpinfo utility prints the DHCP-supplied value(s) of the parameter requested on the command line. The parameter can be identified either by its numeric code in the DHCP specification, or by its mnemonic identifier, as listed in dhcp_inittab(4). This command is intended to be used in command substitutions in the shell scripts invoked by init(1M) at system boot. It first contacts the DHCP client daemon at system boot or in event scripts as described in dhcpagent(1M). It first contacts the DHCP client daemon dhcpagent(1M) to verify that DHCP has successfully completed on the requested interface. If DHCP has successfully completed on the requested interface, dhcpinfo retrieves the values for the requested parameter. Parameter values echoed by dhcpinfo should not be used without checking its exit status. See exit(1).
See dhcp_inittab(4) for the list of mnemonic identifier codes for all DHCP parameters. See RFC 2132, DHCP Options and BOOTP Vendor Extensions for more details on DHCPv4 parameters, and RFC 3315, Dynamic Host Configuration Protocol for IPv6 (DHCPv6), for more details on DHCPv6 parameters.
The output from dhcpinfo consists of one or more lines of ASCII text; the format of the output depends upon the requested parameter. The number of values returned per line and the total number of lines output for a given parameter are determined by the parameter's granularity and maximum values, respectively, as defined by dhcp_inittab(4).
The format of each individual value is determined by the data type of the option, as determined by dhcp_inittab(4). The possible data types and their formats are listed below:
| Data Type | Format | dhcp_inittab(4) type |
| Unsigned Number | One or more decimal digits |
UNUMBER8, UNUMBER16, UNUMBER32, UNUMBER64
|
| Signed Number | ||
| IP Address | ||
| IPv6 Address | ||
| Octet | ||
| String | ||
| DUID | ||
| Domain Name |
The following options are supported:
-c
-i interface
For DHCPv6, the interface name used should be the name of the physical interface, not one of the logical interfaces created by dhcpagent.
-n limit
-v4 | 6
The following operands are supported:
code
identifier
The following exit values are returned:
0
2
3
4
6
See attributes(5) for descriptions of the following attributes:
| |||||||||
dhcpagent(1M), ifconfig(1M), init(1M), dhcp_inittab(4), attributes(5)
Alexander, S., and R. Droms, RFC 2132, DHCP Options and BOOTP Vendor Extensions, Silicon Graphics, Inc., Bucknell University, March 1997.
Droms, R. , RFC 3315, Dynamic Host Configuration Protocol for IPv6 (DHCPv6), Cisco Systems, July 2003.
Mockapetris, P.V. , RFC 1035, Domain names - implementation and specification, ISI, November 1987.