ntpq 命令

在线编辑

用途

启动标准的网络时间协议 (NTP) 查询程序。

语法

ntpq [ -i ] [ -n ] [ -p ] [ -c SubCommand ] [ 主持人 ... ]

描述

此 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 子命令。

参数

项 描述
主机 ... 指定主机。

退出状态

本命令返回以下退出值：

项 描述
重大安全事件数量 成功完成。
> 0 发生错误。

安全性

访问控制：必须是系统组的成员才能运行该命令。

审计事件：N/A

RBAC 用户和可信 AIX® 用户注意: 此命令可以执行特权操作。 只有特权用户才能执行特权限定的操作。 有关权限与特权的更多信息，请参阅安全性中的“特权限定的命令数据库”。 有关与该命令相关联的特权和权限的列表，请参阅 lssecattr 命令或 getcmdattr 子命令。

示例

  1. 要以交互方式启动网络时间协议查询程序，请输入:
    ntpq -i
  2. 要将 1000 毫秒的时间间隔添加到时间戳记，请输入:
    ntpq -c "delay 1000"

ntpq 内部子命令

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

交互格式子命令

交互式格式子命令由 0 到 4 个自变量跟随的关键字组成。 只需输入整个关键字的足够的字符来唯一标识子命令。 子命令的输出转至标准输出，但您可以将单个子命令的输出重定向至文件，方法是向命令行追加> (大于号) ，后跟文件名。

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

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

Variable=Value

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

项 描述
? [ SubCommand ] 显示命令用法信息。 当使用时，如果没有带 SubCommand，显示所有的 ntpq 命令关键字的一个列表。 当使用时，如果带有 SubCommand，显示子命令的功能和用法。
addvars 变量 [=值 ] [， ...] 指定变量和它们的可选值，添加到内部数据列表中。 如果添加的变量超出一个，列表就必须由逗号隔开，并且不包含空格。
认证 yes | no 指定是否发送全部请求的认证。 一般，ntpq 查询程序不认证请求，除非它们是写请求。
清除变量 从内部数据列表中全部除去变量。
已煮熟 显示从重定格式的远程服务器接收的所有结果。 尾随? (问号) 标记没有可解码值的变量。
调试 更多 | 更少 | 关闭 将 ntpq 查询程序调试置为开或关。 more 和 less 选项控制着冗长的输出。 如果输入此子命令没有带自变量，那么它打印子命令的当前设置。
延迟 MilliSeconds 指定时间间隔添加到包含在需要认证的请求中的时间标记中。 使用此子命令可以在长延迟网络路径上、或时钟不同步的机器之间进行不可靠服务器的重新配置。 如果输入此子命令没有带自变量，那么它打印子命令的当前设置。
主机 HostName 指定查询被发送至的主机。 HostName 可以是主机名，也可以是数字地址。 如果输入此子命令没有带自变量，那么它打印子命令的当前设置。
主机名 yes | no 指定是否输出主机名（yes）或者数字地址（no）。 缺省值为 yes 除非 -n 标志使用了。 如果输入此子命令没有带自变量，那么它打印子命令的当前设置。
keyid 编号 指定认证配置请求的服务器密钥数字。 如果输入此子命令没有带自变量，那么它打印子命令的当前设置。
ntpversion 1 | 2 | 3 当轮询它的数据包时，指定使用的 NTP 版本实现。 缺省值是 3。 如果输入此子命令没有带自变量，那么它打印子命令的当前设置。
注: Mode 6 控制消息和方式在 NTP 版本 1 中不存在。
passwd 提示输入 NTP 服务器认证密码来认证配置请求。
退出 退出 ntpq 查询程序。
原始 显示所有从远程服务器接收的没有格式化的结果。 只变换非 ASCII 字符为可显示格式。
rmvars 变量 [=值 ] [， ...] 指定可从内部数据列表除去的变量及它们的可选值。 如果除去的变量超出一个，列表就必须由逗号隔开，并且不包含空格。
超时 MilliSeconds 指定响应服务器查询的超时周期。 缺省值为 5000 毫秒。 如果输入此子命令没有带自变量，那么它打印子命令的当前设置。
注: 因为 ntpq 查询程序在超时后重试每个查询一次，所以超时的总等待时间是超时值集的两倍。

控制消息子命令

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

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

项 描述
关联 获取并显示所查询服务器的符合规范对等服务器的关联标识和对等服务器状态的列表。 列表显示为下列栏：
  • 第一栏包含内部使用的从 1 开始的索引关联的数字。
  • 第二栏包含由服务器返回的实际的关联标识。
  • 第三栏包含同级设备的状态字。
  • 剩余栏包含从状态字解码的数据。
注: 关联 子命令返回的数据在 ntpq 查询程序中以内部方式进行高速缓存。 在处理使用困难关联标识的服务器时，请使用索引作为自变量，格式为&index，作为关联标识的替代方法。
clockvar [ AssocID ] [ 变量 [=值 ] ， ...] 或 cv [ AssocID ] [ Variable [=Value ] ， ...] 显示服务器的时钟变量列表。 具有无线电时钟或其他外部同步的服务器肯定地响应它。 要请求系统时钟变量，请将 AssocID 留空或输入 0。 如果服务器将时钟视为伪对等，并且可能同时连接了多个时钟，那么引用相应的对等关联标识将显示特定时钟的变量。 省略变量值引起服务器返回缺省值变量显示。
协会 显示关联标识和对于所有关联的、服务器正在维护的同级设备状态的列表。 此子命令不同于 associations 子命令只对于保持有对于 out-of-spec 客户机关联的状态服务器。
lp关联 从关联的内部高速缓存显示对所有关联的数据，包括 out-of-spec 客户机关联。
lpeer 显示服务器维护状态所有关联的总结，类似于 peers 子命令。 可能从 out-of-spec 客户机/服务器产生同级设备的一个很长的列表。
mreadvar AssocID AssocID [ Variable [=Value ] ， ...] 或 mrv AssocID AssocID [ Variable [=Value ] ， ...] 对于给定非零关联标识的每个服务器，显示出指定同级设备变量值。 由最新的关联命令高速缓存的关联列表来确定范围。
mreadlist AssocID AssocID 或 mrl AssocID AssocID 对于给定非零关联标识的每个服务器，显示出指定同级设备在内部变量列表中的变量值。 由最新的关联命令高速缓存的关联列表来确定范围。
操作程序 peers 子命令的旧格式。 用本地接口地址代替引用标识。
p关联 显示以内部方式进行高速缓存的关联列表中与符合规范的对等服务器相关的关联数据。 此子命令的运行相似于 associations 子命令，除了它显示内部存储的数据，而不是执行一个新建的查询。
同级 显示服务器检查同级设备的列表，并显示每一个同级设备状态的总结。 总结数据包含如下：
  • 远程同级设备的地址
  • 引用标识（未知的引用标识 0.0.0.0）
  • 远程同级设备的层次（16 层次表示远程同级设备是不同步的）
  • 同级设备的类型（本地，单点广播，多点广播或广播）
  • 上一个数据包接收的时间，轮询时间间隔（秒）
  • 轮询时间间隔（秒）
  • 可达性注册（八进制）
  • 同级的当前估计延迟，偏移和离散 (毫秒)

左边距中的字符表示时钟选择进程中同级设备的结局：

空间/空格/空号脉冲 (space)
高层次的废弃和/或失败的安全检查。
x
由交集算法指定的 falseticker。
.
从候选列表底端精选。
-
由集群算法废弃。
+
包含在最终的选择集中。
#
选定距离超出最大值的同步。
*
选择同步。
o
选定正在使用中的 pps 同步信号。

主机字段内容可以是主机名、IP 地址、带参数的参考时钟实现名或 REFCLK（ImplementationNumber, Parameter）。 当使用 hostnames no 时，只能显示 IP 地址。

注意：

此 peers 子命令取决于分析对所获取的响应值的能力。 它可能不时与不能很好地控制数据格式的服务器产生工作故障。

此 peers 子命令是非原子的，可能偶尔导致关于启动和终止命令的无效关联的伪错误消息。
状态 AssocID 显示通过发送读状态请求带有给定关联的服务器的同级设备变量的名称和值。 输出以十六进制形式和英文形式显示变量之前的头。
readlist [ AssocID ] 或 rl [ AssocID ] 显示出带有给定关联的服务器内部变量列表中同级设备变量的值。 请求系统变量，用 AssocID 空格或输入 0。 如果内部变量列表是空的，服务器返回缺省变量显示。
readvar [ AssocID ] [ 变量 [=值 ] ， ...] 或 rv [ AssocID ] [ Variable [=Value ] ， ...] 显示通过发送读变量请求带有给定关联的服务器的指定同级设备变量的值。 请求系统变量，用 AssocID 空格或输入 0。 省略变量值引起服务器返回缺省值变量显示。
writevar [ AssocID ] [ Variable [ =Value ], ... ] 通过发送写变量请求写出带有给定关联的服务器的指定同级设备变量的值。
写入列表 [ AssocID ] 写出带有给定关联的服务器内部变量列表中同级设备变量的值。

文件

项 描述
/usr/sbin/ntpq 包含 ntpq 命令。