pm_set_program_wp 子例程

用途

为指定的工作负载分区 (WPAR) 设置性能监视器编程。

语法

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

描述

pm_set_program_wp 子例程为属于指定工作负载分区 (WPAR) 的进程设置性能监视器编程。编程包括要计数的事件以及要计数的方式。

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

在某些平台中，可以指定事件组而不是个别事件。在方式中设置 is_group 位字段，并在事件数组的第一个元素中输入组标识。可以通过 pm_initialize 子例程获取组标识。

计数方式包括 "用户" 方式和 "内核" 方式，或其中任一方式， "初始计数" 状态和 "进程树" 方式。如果 "进程树" 方式设置为 On 状态，那么计数仅适用于调用进程及其后代。用户方式和内核方式的缺省值为 Off。初始缺省状态设置为延迟计数，直到调用 pm_start 子例程，并对正在运行到指定 WPAR中的所有进程的活动进行计数。

参数

项描述

CID 指定要为其设置子例程的 WPAR 的标识。可使用 getcorralid 系统调用从 WPAR 名称获取 CID。

项	描述
CID	指定要为其设置子例程的 WPAR 的标识。可使用 getcorralid 系统调用从 WPAR 名称获取 CID。
PROG	指定要在 "性能监视器" 设置中使用的事件和方式。支持以下方式: 用户对以用户方式运行的进程进行计数。缺省值设置为 `Off`。 PM_KERNEL 对以内核方式运行的进程进行计数。缺省值设置为 `Off`。 PM_COUNT 立即开始计数。缺省值设置为 `Not to start counting`。 PM_PROCTREE 仅针对调用进程及其后代将计数设置为 `On` 。缺省值设置为 `Off`。

PROG

指定要在 "性能监视器" 设置中使用的事件和方式。支持以下方式:

用户: 对以用户方式运行的进程进行计数。缺省值设置为 Off。
PM_KERNEL: 对以内核方式运行的进程进行计数。缺省值设置为 Off。
PM_COUNT: 立即开始计数。缺省值设置为 Not to start counting。
PM_PROCTREE: 仅针对调用进程及其后代将计数设置为 On 。缺省值设置为 Off。

返回值

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

错误代码

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

文件

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