pm_get_program_mx 和 pm_get_program_mm 子例程

在线编辑

用途

以计数器多路复用方式和多方式检索系统范围的性能监视器设置。

库

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

语法

#include <pmapi.h>

int pm_get_program_mx ( *prog)
pm_prog_mx_t *prog;

int pm_get_program_mm (*prog_mm)
pm_prog_mm_t *prog_mm;

描述

pm_get_program_mx 和 pm_get_program_mm 子例程检索当前系统范围的性能监视器设置。 这包括方式信息和正在计数的事件，这些事件位于事件标识列表的数组中。 这些标识来自 pm_initialize 子例程返回的列表。 当您将 pm_get_program_mm 子例程用于多方式计数时，会将一种方式与每个事件列表相关联。

计数模式包括用户模式，内核模式，当前计数状态和进程树模式。 如果设置了进程树方式，那么计数仅适用于调用进程及其后代。

如果列表包含可与阈值一起使用的事件 (如 pm_init 子例程所指示) ，那么还会返回阈值值。

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

用户应用程序必须释放分配用于存储事件列表的数组 (prog 中的 events_set 字段)。

参数

项 描述
PROG 返回设置的性能监视器事件和方式。 它支持以下方式:
PM_USER
正在用户方式下运行的计数进程。
PM_KERNEL
正在内核方式下运行的计数进程。
PM_COUNT
正在进行计数。
PM_PROCTREE
计数仅适用于调用进程及其后代。
进度毫米 返回设置了哪些性能监视器事件和关联方式。 它支持以下方式:
用户
正在用户方式下运行的计数进程。
PM_KERNEL
正在内核方式下运行的计数进程。
PM_COUNT
正在计数。
PM_PROCTREE
计数仅适用于调用进程及其后代。

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

返回值

项 描述
重大安全事件数量 未发生错误。
正错误代码 请参阅 pm_error (pm_error Subroutine) 子例程以解码错误代码。

错误代码

请参阅 pm_error 子例程。

文件

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