pm_get_program_wp_mm 子例程

用途

以计数器多路复用方式返回指定工作负载分区的性能监视器设置。

库

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

语法

#include <pmapi.h>

int pm_get_program_wp_mm (cid, *prog_mm)
cid_t cid;
pm_prog_mm_t *prog_mm;

描述

pm_get_program_wp_mm 子例程以计数器多路复用方式检索指定工作负载分区 (WPAR) 的当前性能监视器设置。这些设置包括方式信息和正在计数的事件，这些事件位于事件标识列表的数组中。必须从 pm_initialize Subroutine 子例程返回的列表中选择标识。如果列表包含可与阈值配合使用的事件，那么还会返回阈值。

当您将 pm_get_program_wp_mm 子例程用于多方式计数时，会将一种方式与每个事件列表相关联。

计数方式包括 "用户" 方式和 "内核" 方式，或其中任一方式; 当前计数状态; 以及 "进程树" 方式。如果设置了 "进程树" 方式，那么计数将仅应用于调用进程及其后代。

如果事件由组标识表示，那么将以方式设置 is_group 位，并且每个事件数组的第一个元素包含组标识。不使用事件数组的其他元素。

用户应用程序必须释放为存储事件列表而分配的数组。

参数

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

项

描述

CID

指定要检索其编程的 WPAR 的标识。可使用 getcorralid 系统调用从 WPAR 名称获取 CID。

程序毫米

返回设置的性能监视器事件和方式。支持以下方式:

用户: 正在用户方式下运行的进程计数。
PM_KERNEL: 对以内核方式运行的进程进行计数。
PM_COUNT: 正在进行计数。
PM_PROCTREE: 仅计算调用进程及其后代的活动。

PM_PROCTREE 方式和 PM_COUNT 方式是所有方式集的公共方式。

返回值

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

错误代码

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

文件

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