pm_set_program_wp_mm 子例程

在线编辑

用途

为指定的 工作负载分区设置以计数器多路复用方式进行的性能监视器编程。

语法

#include <pmapi.h>

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

描述

pm_set_program_wp_mm 子例程以计数器多路复用方式为属于指定 工作负载分区 (WPAR) 的进程设置性能监视器编程。 编程包括要计数的事件数组的列表，以及用于计数每个事件数组的关联方式。 为每个事件数组定义计数方式。 必须从 pm_initialize Subroutine 子例程返回的列表中选择标识。 如果列表包含可与阈值配合使用的事件，那么可以指定阈值。

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

计数方式包括 "用户" 方式和 "内核" 方式，或其中任一方式， "初始计数" 状态和 "进程树" 方式。 用户方式和内核方式的缺省值为 Off。 初始缺省状态设置为延迟计数，直到调用 pm_start 子例程 (pm_start 和 pm_tstart 子例程) ，并对正在运行到指定 WPAR中的所有进程的活动进行计数。

如果将 pm_set_program_wp_mm 子例程用于多方式计数，那么进程树方式 (PM_PROCTREE) 和启动计数方式 (PM_COUNT) 将保留第一个编程集中定义的值。

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

参数

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

返回值

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

错误代码

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

文件

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