dhcpinfo

- 显示通过 DHCP 接收的参数的值

用法概要

dhcpinfo [-c] [-i interface] [-n limit] [-v 4|6] code

dhcpinfo [-c] [-i interface] [-n limit] [-v 4|6] identifier

描述

dhcpinfo 实用程序可显示 DHCP 提供的命令行上所请求的参数的值。可通过 DHCP 规范中的数字代码或通过助记标识符（如 dhcp_inittab(4) 中所列）来标识参数。此命令旨在用于 init(1M) 在系统引导时调用的 shell 脚本中的命令替换。它首先会在系统引导时或在事件脚本中联系 DHCP 客户机守护进程，如 dhcpagent(1M) 中所述。它首先会联系 DHCP 客户机守护进程 dhcpagent(1M)，以验证 DHCP 在请求的接口上是否已成功完成。如果 DHCP 在请求的接口上已成功完成，dhcpinfo 将检索所请求参数的值。对于由 dhcpinfo 回显的参数值，在未检查其退出状态的情况下不应直接使用。请参见 exit(1)。

有关所有 DHCP 参数的助记标识符代码的列表，请参见 dhcp_inittab(4)。有关 DHCPv4 参数的更多详细信息，请参见“RFC 2132，DHCP 选项和 BOOTP 供应商扩展”，有关 DHCPv6 参数的更多详细信息，请参见“RFC 3315，适用于 IPv6 的动态主机配置协议 (Dynamic Host Configuration Protocol for IPv6, DHCPv6)”。

输出格式

来自 dhcpinfo 的输出由一行或多行 ASCII 文本组成；输出的格式取决于所请求的参数。给定参数的输出中每行返回的值数和总行数分别由参数的粒度值和最大值确定，如 dhcp_inittab(4) 所定义。

每个值的格式由选项的数据类型确定，如 dhcp_inittab(4) 所确定的那样。下面列出了可能的数据类型及其格式：

选项

支持下列选项：

-c

以规范格式显示输出。此格式与粒度为 1 的 OCTET 格式完全相同。

-i interface

指定从其检索 DHCP 参数值的接口。如果未指定此选项，则使用主接口。

如果尚未通过 ifconfig(1M) 为系统或通过 -i 为此命令选择主接口，系统将自动选择一个接口作为当前命令调用的主接口。系统会选择其名称按词汇顺序排在首位且附带有 DHCP 参数的接口。此选择不会影响系统状态。使用 ifconfig(1M) 设置主接口。

dhcpagent(1M) eventhook 脚本中的建议做法是使用 -i 指定所需接口，而不是依赖于主接口选择。

对于 DHCPv6，所用的接口名称应该是物理接口的名称，而不是由 dhcpagent 创建的某个逻辑接口。

-n limit

将值列表的显示行数限制到 limit 行。

-v4 | 6

指定要查询的 DHCP 版本。对 DHCPv4 使用 -v4，对 DHCPv6 使用 -v6。

操作数

支持下列操作数：

code

所请求 DHCP 参数的数字代码，如 DHCP 规范所定义。通过向 DHCPv4 的实际供应商代码添加 256，向 DHCPv6 的实际供应商代码添加 65536，指定供应商选项。

identifier

所请求 DHCP 参数的助记符号，如 dhcp_inittab(4) 中所列。

退出状态

将返回以下退出值：

0

操作成功。

2

操作失败。DHCP 客户机守护进程可能未在运行，接口可能配置失败，或者没有接收到满意的 DHCP 响应。

3

参数错误。

4

操作超时。

6

系统错误（永远不应发生）。

属性

有关下列属性的描述，请参见 attributes(5)：

另请参见

dhcpagent(1M)、ifconfig(1M)、init(1M)、dhcp_inittab(4)、attributes(5)

Alexander, S. 和 R. Droms，“RFC 2132，DHCP 选项和 BOOTP 供应商扩展”，Silicon Graphics, Inc., Bucknell University，1997 年 3 月。

Droms, R.，“RFC 3315，适用于 IPv6 的动态主机配置协议 (Dynamic Host Configuration Protocol for IPv6, DHCPv6)”，Cisco Systems，2003 年 7 月。

Mockapetris, P.V.，“RFC 1035，域名－实现和规范”，ISI，1987 年 11 月。