pm_get_program 子例程

在线编辑

用途

检索系统范围的性能监视器设置。

库

性能监视器 API 库 (libpmapi.a)

语法

#include <pmapi.h>

int pm_get_program ( *prog)
pm_prog_t *prog;

描述

pm_get_program 子例程检索当前系统范围的性能监视器设置。 这包括方式信息和正在计数的事件，这些事件位于事件标识列表中。 这些标识来自 pm_init 子例程返回的列表。

计数模式包括用户模式，内核模式，当前计数状态和进程树模式。 如果进程树方式处于打开状态，那么计数仅适用于调用进程及其小数。

如果列表包含可与阈值一起使用的事件 (如 pm_init 子例程所指示) ，那么还会返回阈值值。

如果事件由组标识表示，那么将在方式中设置 is_group 位，并且事件数组的第一个元素包含组标识。 事件数组的其他元素没有意义。

参数

项 描述
PROG 返回设置的性能监视器事件和方式。 受支持的方式包括:
PM_USER
对以用户方式运行的进程进行计数
PM_KERNEL
对以内核方式运行的进程进行计数
PM_COUNT
计数开启
PM_PROCTREE
计数仅适用于调用进程及其后代

返回值

项 描述
重大安全事件数量 未发生错误。
正错误代码 请参阅 pm_error 子例程 以解码错误代码。

错误代码

请参阅 pm_error 子例程。

文件

项 描述
/usr/include/pmapi.h 定义标准宏，数据类型和子例程。