QEMU 虚拟 RAPL MSR 辅助程序

用法概要

qemu-vmsr-helper [OPTION]

实现 QEMU 的虚拟 RAPL MSR 辅助服务。

访问 RAPL（Running Average Power Limit，运行平均功率限制）MSR，可以让 RAPL powercap 驱动提供并监控不同功率域的功耗或累计能耗，例如 CPU 封装、DRAM，以及硬件支持的其他组件。

这些寄存器需要特权访问（CAP_SYS_RAWIO）。QEMU 可以通过外部辅助程序访问它们。

qemu-vmsr-helper 就是该程序，它创建监听 socket，接受 QEMU 的连接并进行通信。

在这种环境中运行虚拟机时，应将辅助程序作为系统服务启动。配置 QEMU 连接该 socket 的方法，请参阅手册中的 RAPL MSR 支持章节。

连接 socket 后，qemu-vmsr-helper 可以放弃 root 权限，仅保留工作所需的能力。

它也支持 systemd socket 激活协议。此时 systemd socket 单元应指定 Unix 流式 socket，例如：:

[Socket]
ListenStream=/var/run/qemu-vmsr-helper.sock

-f, --pidfile=PATH: 以守护进程运行时使用的 PID 文件。默认在系统运行时状态目录创建，例如 /var/run/qemu-vmsr-helper.pid.

-k, --socket=PATH: socket 路径。默认在系统运行时状态目录创建，例如 /var/run/qemu-vmsr-helper.sock.

-T, --trace [[enable=]PATTERN][,events=FILE][,file=FILE]

指定跟踪选项。

[enable=]PATTERN

立即启用匹配 PATTERN 的事件，匹配对象可以是事件名或通配符模式。仅当 QEMU 编译时启用了 simple、log 或 ftrace 跟踪后端时，此选项才可用。若要指定多个事件或模式，可以重复使用 -trace。

使用 -trace help 打印跟踪点名称列表。

events=FILE

立即启用 FILE 中列出的事件。文件每行应包含一个事件名，与 trace-events-all 中的名称对应，也接受通配符模式。仅当 QEMU 编译时启用了 simple、log 或 ftrace 跟踪后端时，此选项才可用。

file=FILE

将跟踪日志输出到 FILE。仅当 QEMU 编译时启用了 simple 跟踪后端时，此选项才可用。