pm_get_program_thread 子例程

在线编辑

用途

检索目标线程的性能监视器设置。

库

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

语法

#include <pmapi.h>

int pm_get_program_thread ( pid,  tid,  *prog)
pid_t pid;
tid_t tid;
pm_prog_t *prog;

描述

此子例程仅支持 1: 1 线程技术模型。 它已被 pm_get_program_pthread 子例程取代，该子例程支持 1: 1 和 M: N 线程模型。 对此子例程的调用相当于使用等于 0 的 ptid 参数调用 pm_get_program_pthread 子例程。

pm_get_program_thread 子例程检索目标内核线程的性能监视器设置。 线程必须停止，并且必须是在调用进程控制下的调试进程的一部分。 这包括方式信息和正在计数的事件，这些事件位于事件标识列表中。 这些标识来自 pm_init 子例程返回的列表。

计数模式包括用户模式和内核模式，以及当前计数状态。

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

参数

项 描述
pid 目标线程的进程标识。 目标进程必须是调试进程的自变量。
tid 目标线程的线程标识。
* 程序 返回设置的性能监视器事件和方式。 受支持的方式包括:
PM_USER
对以 用户 方式运行的进程进行计数
PM_KERNEL
对以 Kernel 方式运行的进程进行计数
PM_COUNT
计数开启

返回值

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

错误代码

请参阅 pm_error 子例程。

文件

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