Linux程序员手册 第2部分
更新日期： 2017-09-15

名称

perfmonctl-与IA-64性能监视单元的接口

语法

#include <syscall.h>
#include <perfmon.h>

long perfmonctl(int fd, int cmd, void *arg, int narg);

Note:

There is no glibc wrapper for this system call; see NOTES.

说明

特定于IA-64的perfmonctl()系统调用提供了与PMU(性能监视单元)的接口。 PMU由PMD(性能监视数据)寄存器和PMC(性能监视控制)寄存器组成，它们收集硬件统计信息。

perfmonctl()将操作cmd应用于arg指定的输入参数。参数的数量由narg定义。 fd参数指定要操作的perfmon上下文。

cmd支持的值为：

PFM_CREATE_CONTEXT

设置上下文。

fd参数将被忽略。按照ctxt中的指定创建一个新的perfmon上下文，并在ctxt->ctx_fd中返回其文件描述符。

该文件描述符可用于对perfmonctl()的后续调用中，并可用于使用read(2)读取事件通知(类型pfm_msg_t)。可以使用select(2)，poll(2)和epoll(7)轮询文件描述符。

可以通过在文件描述符上调用close(2)来破坏上下文。

PFM_WRITE_PMCS

设置PMC寄存器。

PFM_WRITE_PMDS

设置PMD寄存器。

PFM_READ_PMDS

读取PMD寄存器。

PFM_START

开始监视。

PFM_STOP

停止监视。

PFM_LOAD_CONTEXT

将上下文附加到线程。

PFM_UNLOAD_CONTEXT

从线程中分离上下文。

PFM_RESTART

收到溢出通知后，重新启动监视。

PFM_GET_FEATURES

perfmonctl(int fd, PFM_GET_FEATURES, pfarg_features_t *arg, 1);

PFM_DEBUG

如果val非零，则启用调试模式，否则禁用。

PFM_GET_PMC_RESET_VAL

将PMC寄存器重置为默认值。

返回值

操作成功时，perfmonctl()返回零。发生错误时，将返回-1并将errno设置为指示错误原因。

版本

从Linux 2.4开始可以使用perfmonctl()。

遵循规范

perfmonctl()是特定于Linux的，仅在IA-64体系结构上可用。

备注

Glibc没有为该系统调用提供包装器；使用syscall(2)调用它。

另外参见

gprof(1)

perfmon2接口规范

出版信息

这个页面是Linux手册页项目5.08版的一部分。有关项目的说明、有关报告错误的信息以及此页面的最新版本，请访问https://www.kernel.org/doc/man-pages/。