Linux lsclocks 怎样列出系统支持的时钟

在 Linux 上想知道“系统支持哪些时钟”，直接看 date 往往不够：它只回答当前日期时间，并不能把 POSIX 时钟、进程 CPU 时钟、PTP、RTC 和辅助时钟放在同一个视图里。lsclocks 是 util-linux 提供的专门工具，默认会列出可发现的系统时钟，并给出当前时间与分辨率。

最小用法是 lsclocks；需要脚本消费时使用 lsclocks -J，需要只看一个对象时使用 -t，自动发现之外的设备则用 --dynamic-clock 或 --rtc 显式补入。

官方地址：https://github.com/util-linux/util-linux/

先确认 lsclocks 的默认清单

先不要急着加很多参数，默认输出最适合确认两件事：命令是否来自当前系统的 util-linux，以及当前环境能发现哪些时钟。它的目标是“列清单”，不是切换内核时钟源，也不是校准 RTC。

# 先查看系统能发现的时钟、当前值和分辨率
lsclocks

# 需要确认工具版本时，使用帮助或版本选项
lsclocks --version

手册把可见对象分为几类：POSIX 时钟包括 CLOCK_MONOTONIC、CLOCK_REALTIME 和 CLOCK_BOOTTIME 等；CPU 时钟来自进程 CPU 时钟接口；PTP 和 RTC 通常对应设备节点；辅助时钟则是系统提供的 CLOCK_AUX* 对象。清单里看不到某类对象，不等于 Linux 完全不支持它，可能只是当前主机没有相应设备或发现条件。

为什么默认结果和硬件时钟不是一回事

排查时最容易混淆的是“时钟对象”和“内核选中的 clocksource”。Linux 内核的 timekeeping 文档讨论的是内核如何读取时钟源来维护时间；lsclocks 则提供用户空间可观察对象的清单、当前时间和分辨率。两者相关，但不是同一个查询。

可以按下面的思路判断：

• 只想知道可用对象：先看默认 lsclocks 输出。
• 想看某个硬件时钟：关注 /dev/ptp0、/dev/rtc0 这类路径，并用显式参数加入。
• 想分析调度或计时精度：关注 TIME、RESOL，再结合程序实际使用的 clock ID。

因此，看到 RTC 行并不能推出系统当前正在用 RTC 做所有单调计时；同样，看到高分辨率字段也不能直接推出业务延迟一定更低。

用列选择和单时钟查询缩小范围

默认表格适合人读，排查特定问题时可以减少字段。--output 选择需要的列，--output-all 展开全部列；具体列名以当前系统的帮助输出为准。手册列出的字段包括原始名称、短名称、当前时间、ISO8601 时间、原始分辨率和可读分辨率。

# 只保留名称、可读时间和可读分辨率，便于人工比较
lsclocks --output NAME,TIME,RESOL

# 查看当前版本支持的全部列，再按需复制列名
lsclocks --help

# 只查询一个时钟；这里的名称应替换为默认清单中真实存在的名称
lsclocks --time CLOCK_MONOTONIC

-t（--time）用于显示一个指定时钟的当前值。它不是“把系统时间改成这个时钟”，也不会改变内核时钟配置。若只是为了脚本稳定解析，不要依赖人读表格中的空格对齐，优先考虑下一节的 JSON 输出。

用 JSON、动态时钟和 RTC 处理特殊环境

当结果要交给 shell、Python 或监控采集器时，使用 -J（--json）更合适。JSON 只改变输出格式，不会凭空增加主机上不存在的时钟。

# 用 JSON 输出，避免脚本依赖表格列宽
lsclocks -J

# 明确加入一个动态时钟；路径应替换为环境中确实存在的设备
lsclocks --dynamic-clock /dev/ptp0

# 明确加入 RTC；没有该设备时不要把路径写死到部署脚本
lsclocks --rtc /dev/rtc0

默认情况下，工具会尝试发现动态时钟和 RTC；--no-discover-dynamic、--no-discover-rtc 可以关闭对应的自动发现。如果你需要测试“仅保留默认对象”的采集行为，这两个选项很有用。反过来，容器、虚拟机或权限受限环境中，显式路径可能不存在、不可访问或不代表宿主机的完整设备集合，脚本应把“没有该行”当成环境差异处理，而不是直接判定命令失效。

常见误区与速查

最后可以按三步复查：先用默认输出确认对象范围，再用 -o 或 -t 缩小问题，最后用 -J 固化脚本输入。这样既不会把“显示时钟”误认为“切换时钟源”，也能把设备差异留在明确的边界里。

相关问题

lsclocks 能修改系统时间吗？

不能。它负责显示时钟对象及其属性；修改系统时间、校准 RTC 或选择内核时钟源属于其他工具和配置路径。

为什么不同机器上的 lsclocks 行数不同？

POSIX 时钟、进程 CPU 时钟、PTP、RTC 和动态设备的可见性受内核、硬件、容器和权限影响，清单不同是正常边界。

脚本应该解析哪个字段？

优先使用 -J 的结构化结果，并按实际需求选择 NAME、TIME、ISO_TIME 或 RESOL，不要依赖默认表格的列顺序。