pm_set_program 子例程

在线编辑

用途

设置系统范围的性能监视器程序化。

库

性能监控器应用程序接口库libpmapi.a

语法

#include <pmapi.h>

int pm_set_program ( *prog)
pm_prog_t *prog;

描述

pm_set_program子程序设置系统范围内的性能监控程序。 此设置包括要计数的事件以及要计数的方式。 要计数的事件位于事件标识列表中。 必须从pm_init子程序返回的列表中选择标识符。

计数模式包括用户模式和/或内核模式、初始计数状态和进程树模式。 仅对于调用进程及其后代， "进程树方式" 设置为 "开启"。 对于 "用户方式" 和 "内核方式" ，缺省值设置为 "关闭"。 初始默认状态设置为延迟计数，直到pm_start子程序被调用，并对系统中运行的所有进程的活动进行计数。

如果列表中包含可与阈值一起使用的事件（如pm_init子程序所示），则还可以指定一个阈值。

在某些平台上，可以指定事件组，而不是个别事件。 具体做法是在模式中设置位字段is_group，并将组 ID 放入事件数组的第一个元素。 (组 ID 由pm_init 获得）。

参数

项 描述
* 程序 指定要在 "性能监视器" 设置中使用的事件和方式。 支持以下方式:
PM_USER
以用户方式运行的进程计数 (缺省值设置为 "关闭")
PM_KERNEL
以内核方式运行的进程计数 (缺省值设置为 "关闭")
PM_COUNT
立即开始计数（默认设置为不开始计数）
PM_PROCTREE
仅针对调用进程及其后代将计数设置为 "开启" (缺省值设置为 "关闭")

返回值

项 描述
0 操作成功完成。
Positive error code 请参阅 pm_error 子例程 以解码错误代码。

错误代码

请参阅 pm_error 子例程。

文件

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