pm_get_program_wp 子例程

在线编辑

用途

检索指定 工作负载分区 (WPAR) 的系统范围性能监视器设置。

库

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

语法

#include <pmapi.h> 
int pm_get_program_wp (cid, *prog)
cid_t cid;
pm_prog_t *prog;

描述

pm_get_program_wp 子例程检索属于指定 工作负载分区的进程的系统范围性能监视器设置。 这些设置包括方式信息和正在计数的事件。

正在计数的事件位于事件标识列表中。 必须从 pm_init 子例程返回的列表中选择标识。 如果列表包含可与阈值配合使用的事件，那么可以指定阈值。

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

计数方式包括 "用户" 方式和 "内核" 方式，或其中任一方式， "初始计数" 状态和 "进程树" 方式。

如果 "进程树" 方式设置为 On 状态，那么计数仅适用于调用进程及其后代。

参数

项 描述
CID 指定子例程要检索的 WPAR 的标识。 可使用 getcorralid 系统调用从 WPAR 名称获取 CID。
PROG 返回设置的性能监视器事件和方式。 支持以下方式:
用户
正在用户方式下运行的进程计数。
PM_KERNEL
对以内核方式运行的进程进行计数。
PM_COUNT
正在进行计数。
PM_PROCTREE
仅计算调用进程及其后代。

返回值

项 描述
重大安全事件数量 操作成功完成。
正错误代码 运行 pm_error 子例程以解码错误代码。

错误代码

要解码错误代码，请参阅 pm_error 子例程。

文件

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