时钟频率（CLOCK）

本文为NVIDIA-SMI系列命令详解第十七篇-时钟频率，介绍和演示了nvidia-smi 命令的 clocks 选项及其附加参数，命令如下：

nvidia-smi clocks

该命令用于控制和查询时钟频率相关信息。当前仅适用于同步超频。

支持的参数列表如下：

    [-i | --id]: 枚举索引, PCI 总线 ID 或者 UUID。多个设备时使用逗号隔开。
    [ | --sync-boost-list]: 列举所有同步超频组
    [ | --sync-boost-add]: 添加一个同步超频组

    [ | --sync-boost-remove]: 删除一个同步超频组。
                              组 id 从 --sync-boost-list 获取。

    [-h | --help]: 显示帮助信息

各参数详解

-i 指定 GPU 的标识

GPU 设备的自然枚举序号，PCI 总线地址，或者UUID。多个设备时使用逗号隔开。

运行示例

将 0, 1 号 GPU 添加到同步超频组

nvidia-smi clocks -i 0,1 --sync-boost-add

可以看到 0, 1 号 GPU 成功被加入到同步超频组 0。

–sync-boost-list 列举所有同步超频组

列举所有同步超频组

运行示例

列举所有同步超频组

 nvidia-smi clocks --sync-boost-list

可以看到， 0 号同步超频组里面 有 0,1号 GPU，1号同步超频组里面有 5,6号 GPU。

–sync-boost-add 增加一个同步超频组

增加一个同步超频组

运行示例

将5,6号 GPU 增加到一个同步超频组

nvidia-smi clocks -i 5,6 --sync-boost-add

可以看到，5,6号 GPU 成功添加到 1号同步超频组。

注意：

同一个 GPU 只能被添加到一个超频组。

如图，在5,6号 GPU 已经添加到 1号 同步超频组的情况下，再将 5 号 GPU 添加到一个新的同步超频组会报错。

–sync-boost-remove 列举所有同步超频组

删除一个同步超频组，组 id 从 –sync-boost-list 获取。

运行示例

删除 0 号 同步超频组

 nvidia-smi clocks --sync-boost-remove 0

删除前：

删除后：

可以看到， 0 号同步超频组已经被删除。

-h 打印帮助信息

运行示例

展示 nvidia-smi clocks 的帮助信息

nvidia-smi clocks -h

对应内容如下：

nvidia-smi clocks -h

    clocks -- Control and query clock information.

    Usage: nvidia-smi clocks [options]

    Options include:
    [-i | --id]: Enumeration index, PCI bus ID or UUID. Provide comma
                 separated values for more than one device

    [ | --sync-boost-list]: List all synchronous boost groups

    [ | --sync-boost-add]: Add a synchronous boost group

    [ | --sync-boost-remove]: Remove a synchronous boost group. Provide the group id
                 returned from --sync-boost-list

    [-h | --help]: Display help information