pm_get_data_thread ， pm_get_tdata_thread 或 pm_get_Tdata_thread 子例程

用途

返回目标线程的性能监视器数据。

库

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

语法

#include <pmapi.h>

int pm_get_data_thread (pid,  tid,  *pmdata)
pid_t pid;
tid_t tid;
pm_data_t *pmdata;

int pm_get_tdata_thread (pid, tid, *pmdata, *time)
pid_t pid;
tid_t tid;
pm_data_t *pmdata;
timebasestruct_t *time;

int pm_get_Tdata_thread (pid, tid, *pmdata, * times)
pm_data_t *pmdata;
pid_t pid;
tid_t tid;
pm_data_t *pmdata;
pm_accu_time_t *times;

描述

这些子例程仅支持 1: 1 线程技术模型。 它们已被 pm_get_data_pthread 和 pm_get_tdata_pthread 子例程取代，它们支持 1: 1 和 M: N 线程模型。 对这些子例程的调用相当于对 ptid 参数等于 0 的 pm_get_data_pthread 和 pm_get_tdata_pthread 子例程的调用。

pm_get_data_thread 子例程检索目标内核线程的当前性能监视器数据。 该线程必须停止，并且必须是在调用进程控制下的调试进程的一部分。

pm_get_tdata_thread 子例程检索目标线程的当前性能监视器数据以及指示上次读取硬件计数器的时间的时间戳记。

pm_get_Tdata_thread 子例程检索目标线程的当前性能监视器数据，并且计算事件的累积时间 (时间基准， PURR 时间和 SPURR 时间)。

性能监视器数据始终是 64 位值的集合 (在所使用的机器上每个硬件计数器一个)。

参数

返回值

错误代码

请参阅 pm_error 子例程。

文件