pm_set_program_mygroup 子例程

用途

为调用线程设置性能监视器编程并创建计数组。

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

语法

#include <pmapi.h>

int pm_set_program_mygroup ( *prog)
pm_prog_t *prog;

描述

pm_set_program_mygroup子程序为调用的内核线程设置性能监控程序。 此设置包括要计数的事件以及要计数的方式。 要计数的事件位于事件标识列表中。 必须从pm_init子程序返回的列表中选择标识符。

此调用还会创建计数组,该组包括调用线程以及它或它的任何后代将来将创建的任何线程。 (可选) 可以将该组定义为还包含属于调用进程的所有现有线程和未来线程。

计数方式包括用户方式和/或内核方式以及初始计数状态。 用户模式和内核模式的默认设置为关闭,初始默认状态为延迟计数,直到调用pm_start_mygroup子程序。

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

参数

描述
* 程序 指定在性能监控设置中使用的事件和模式。 支持以下方式:
用户
以用户方式运行的进程计数 (缺省值设置为 "关闭")
PM_KERNEL
以内核方式运行的进程计数 (缺省值设置为 "关闭")
PM_COUNT
立即开始计数(默认设置为不开始计数)
PM_PROCESS
创建进程级别计数组

返回值

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

错误代码

请参阅 pm_error 子例程

文件

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