AIX命令参考大全，卷 4，n - r

ntpq 命令

用途

启动标准的网络计时协议（NTP）查询程序。此命令仅适用于 AIX 4.2 或者后期版本。

语法

ntpq [ -i ] [ -n ] [ -p ] [ -c SubCommand ] [ Host ... ]

描述

此 ntpq 命令查询运行在主机上的 NTP 服务器，该主机指定能实现推荐的关于当前状态的 NTP 模式 6 的控制消息格式，并能在该状态下请求更改。它以交互模式运行，或者通过使用命令行参数运行。您可以请求对任意变量进行读写，原型的和格式化的输出选项是可用的。 ntpq 命令也能够通过给服务器发送多个查询，来获得和打印同级设备公共格式的打印列表。

如果输入 ntpq 命令，并带有一个或多个标志，运行在每个指定的主机（或缺省为本地主机）上的 NTP 服务器接收每个请求。如果不输入任何标志， ntpq 命令试图从标准输入中读取命令，并在运行在指定的第一个主机上或者缺省情况下本地主机上的 NTP 服务器上运行它们。如果标准输入是终端的，它提示输入子命令。

ntpq 命令使用 NTP 模式 6 数据包与 NTP 服务器通信，能够在允许的网络上查询任意的兼容的服务器。

ntpq 命令试图重新发送请求，如果远程主机在合适的时间内没有响应，它将是一个超时请求。

指定一个不是 -i 或者 -n 的标志会给指定的主机立即发送查询。否则， ntpq 命令试图从标准输入中读取交互式格式的子命令。

标志

-c SubCommand	指定交互式格式的命令。此标志添加 SubCommand 到运行在指定主机上的命令列表。输入多个 -c 标志。
-i	指定交互式方式。标准输出显示提示，标准输入读取命令。
-n	以点十进制格式（x.x.x.x）显示所有的主机地址，而不是规范的主机名称。
-p	显示服务器同级设备的列表，并显示一个它们状态的总结。如同使用 peers 子命令。

参数

Host ...

指定主机。

退出状态

此命令返回下列出口值：

0	成功完成。
>0	发生错误。

安全性

访问控制：运行此命令必须是系统组中的一部分。

审计事件：N/A

示例

以交互式方式，启动网络计时协议查询程序，请输入：
```
ntpq -i
```
给时间标志添加一个 1000 毫秒的时间间隔，请输入：
```
ntpq -c "delay 1000"
```

ntpq 内部子命令

下列子命令只能在运行 ntpq 查询程序时使用。

交互式格式的子命令

交互式格式子命令包含有零到 4 个参数跟随的关键字。您只需输入整个关键字的足够的字符来唯一标识子命令。子命令输出到标准输出，但是您可以通过对于命令行附加 > （大于符号），然后跟随一个文件名来重定向单个子命令的输出到一个文件。

有些交互式格式的子命令全部运行在 ntpq 查询程序中，但并不导致发送 NTP 模式 6 请求到服务器。

NTP 模式 6 消息携带的数据包含有格式项列表：

Variable=Value

其中 Value 忽略了，或省略了，请求服务器读取变量。 ntpq 查询程序维护了一个内部列表，列表中包含在控制消息中的数据能够使用 readlist 和 writelist 控制消息子命令进行汇编和发送。

? [ SubCommand ]	显示命令使用信息。当使用时，如果没有带 SubCommand，显示所有的 ntpq 命令关键字的一个列表。当使用时，如果带有 SubCommand，显示子命令的功能和用法。
addvarsVariable [ =Value ] [ ,... ]	指定变量和它们的可选值，添加到内部数据列表中。如果添加的变量超出一个，列表就必须由逗号隔开，并且不包含空格。
authenticate yes \| no	指定是否发送全部请求的认证。一般，ntpq 查询程序不认证请求，除非它们是写请求。
clearvars	从内部数据列表中全部除去变量。
cooked	显示从重定格式的远程服务器接收的所有结果。结尾？标记没有解码值的变量。
debug more \| less \| off	把 ntpq 查询程序调试置为开或关。 more 和 less 选项控制着冗长的输出。如果输入此子命令没有带参数，它打印子命令的当前设置。
delay Milliseconds	指定时间间隔添加到包含在需要认证的请求中的时间标记中。此子命令使不可靠的服务器在长延迟网络路径上，或者时钟不同步的计算机之间重新配置。如果输入此子命令没有带参数，它打印子命令的当前设置。
host HostName	指定主机发送查询。 HostName 可以是主机名，也可以是数字地址。如果输入此子命令没有带参数，它打印子命令的当前设置。
hostnames yes \| no	指定是否输出主机名（yes）或者数字地址（no）。缺省值为 yes 除非 -n 标志使用了。如果输入此子命令没有参数，它打印子命令的当前设置。
keyid Number	指定了认证配置请求的服务器密钥数字。如果输入此子命令没有参数，它打印子命令的当前设置。
ntpversion 1 \| 2 \| 3	当轮询它的数据包时，指定使用的 NTP 版本实现。缺省值是 3。如果输入此子命令没有参数，它打印子命令的当前设置。注: 方式 6 控制信息和方式在 NTP V1.0 中不存在。
passwd	提示输入 NTP 服务器认证密码，来认证配置请求。
quit	退出 ntpq 查询程序。
raw	显示所有从远程服务器接收的没有格式化的结果。只变换非 ASCII 字符为可打印格式。
rmvars Variable [ =Value ] [ ,... ]	指定可从内部数据列表除去的变量及它们的可选值。如果除去的变量超出一个，列表就必须由逗号隔开，并且不包含空格。
timeout 毫秒	指定响应服务器查询的超时周期。缺省值是 5000 毫秒。如果输入此子命令没有参数，它打印子命令的当前设置。注: 由于 ntpq 查询程序在一个超时后重试每个请求，一个超时总的等待时间是超时设置值的两倍。

控制消息子命令

对于 NTP 服务器每个同级设备分配有一个 16 位的整数关联标识。携带有同级设备变量的 NTP 控制信息必须通过包含关联 ID 值，标识值对应的同级设备。一个值为 0 的关联 ID 是特殊的 ID，它表示该变量为系统变量，它的名称是从一个隔离的名称空间中得出的。

此 ntpq 控制消息子命令产生一个或多个 NTP 方式 6 信息发送给服务器，输出以一些格式返回的数据。大多数的子命令当前实现发送单个消息，就希望等到单个响应。当前例外是 peers 子命令，发送一系列的预编程信息来获取它所需要的数据, mreadlist 和 mreadvar 子命令，在一个关联的范围内迭代。

associations	获得和打印关联标识和检查正在查询的服务器的同级设备状态的列表。列表打印为下列栏：第一栏包含内部使用的从 1 开始的索引关联的数字。第二栏包含由服务器返回的实际的关联标识。第三栏包含同级设备的状态字。剩余栏包含从状态字解码的数据。注: 由 associations 子命令返回的数据缓存在 ntpq 查询程序内部。当处理使用复杂关联标识的服务器时，使用索引作为参数。在格式 `&索引` ，作为关联标识的备用项。
clockvar [ AssocID ] [ Variable [ =Value ], ... ] 或 cv [ AssocID ] [ Variable [ =Value ], ... ]	显示服务器的时钟变量列表。具有无线电时钟或其它外部同步的服务器肯定地响应它。请求系统时钟变量，使用 AssocID 空格或输入 `0`。如果服务器把时钟当作伪同级设备，并可能立刻连接上多个时钟，引用适当的同级设备关联标识就能显示特定的时钟变量。省略变量值引起服务器返回缺省值变量显示。
lassociations	显示关联标识和对于所有关联的、服务器正在维护的同级设备状态的列表。此子命令不同于 associations 子命令只对于保持有对于 out-of-spec 客户机关联的状态服务器。
lpassociations	从关联的内部高速缓存显示对所有关联的数据，包括 out-of-spec 客户机关联。
lpeers	显示服务器维护状态所有关联的总结，类似于 peers 子命令。可能从 out-of-spec 客户机／服务器产生同级设备的一个很长的列表。
mreadvar AssocID AssocID [ Variable [ =Value ], ... ] 或 mrv AssocID AssocID [ Variable [ =Value ], ... ]	对于给定非零关联标识的每个服务器，显示出指定同级设备变量值。由最新的关联命令高速缓存的关联列表来确定范围。
mreadlist AssocID AssocID 或 mrl AssocID AssocID	对于给定非零关联标识的每个服务器，显示出指定同级设备在内部变量列表中的变量值。由最新的关联命令高速缓存的关联列表来确定范围。
opeers	peers 子命令的旧格式。用本地接口地址代替引用标识。
passociations	从内高速缓存的关联列表中显示与符合规格的同级设备有关的关联数据。此子命令的运行相似于 associations 子命令，除了它显示内部存储的数据，而不是执行一个新建的查询。
同级设备	显示服务器检查同级设备的列表，并显示每一个同级设备状态的总结。总结信息包含如下：远程同级设备的地址引用标识（未知的引用标识 0.0.0.0）远程同级设备的层次（16 层次表示远程同级设备是不同步的）同级设备的类型（本地，单点广播，多点广播，或广播）上一个信息包接收的时间，轮询时间间隔（秒）轮询时间间隔（秒）可达性注册（八进制）同级设备的当前估计延迟、偏移量、分散度（秒）左边距中的字符表示时钟选择进程中同级设备的结局：空格高层次的废弃和/或失败的安全检查。 x 由交集算法指定的 falseticker。 . 从候选列表底端精选。 - 由群集算法废弃。 + 包含在最终的选择集中。 # 选定距离不超出最大值的同步。 * 选择同步。 o 选定正在使用中的 pps 同步信号。主机字段内容可以是主机名，IP 地址，带有参数的引用时钟实现或者 REFCLK（ ImplementationNumber，参数）。当使用 hostnames no 时，只能显示 IP 地址。注: 此 peers 子命令取决于分析对所获取的响应值的能力。它可能不时与不能很好地控制数据格式的服务器产生工作故障。此 peers 子命令是非原子的，可能偶尔导致关于启动和终止命令的无效关联的伪错误消息。
pstatus AssocID	显示通过发送读状态请求带有给定关联的服务器的同级设备变量的名称和值。输出显示了先于变量的报头，是以十六进制和英文两种形式。
readlist [ AssocID ] 或 rl [ AssocID ]	显示出带有给定关联的服务器内部变量列表中同级设备变量的值。请求系统变量，用 AssocID 空格或输入 `0`。如果内部变量列表是空的，服务器返回缺省变量显示。
readvar [ AssocID ] [ Variable [ =Value ], ... ] 或 rv [ AssocID ] [ Variable [ =Value ], ... ]	显示通过发送读变量请求带有给定关联的服务器的指定同级设备变量的值。请求系统变量，用 AssocID 空格或输入 `0`。省略变量列表引起服务器返回缺省变量显示。
writevar [ AssocID ] [ Variable [ =Value ], ... ]	通过发送写变量请求写出带有给定关联的服务器的指定同级设备变量的值。
writelist [ AssocID ]	写出带有给定关联的服务器内部变量列表中同级设备变量的值。

文件

/usr/sbin/ntpq

包含 ntpq 命令。