pm_get_data_thread, pm_get_tdata_thread or pm_get_Tdata_thread Subroutine
Purpose
Returns Performance Monitor data for a target thread.
Library
Performance Monitor APIs Library (libpmapi.a)
Syntax
#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;
Description
These subroutines support only the 1:1 threading model. They have been superseded by the pm_get_data_pthread and pm_get_tdata_pthread subroutines, which support both the 1:1 and the M:N threading models. Calls to these subroutines are equivalent to calls to the pm_get_data_pthread and pm_get_tdata_pthread subroutines with a ptid parameter equal to 0.
The pm_get_data_thread subroutine retrieves the current Performance Monitor data for a target kernel thread. The thread must be stopped and must be part of a debuggee process under the control of a calling process.
The pm_get_tdata_thread subroutine retrieves the current Performance Monitor data for a target thread, and a timestamp indicating the last time the hardware counters were read.
The pm_get_Tdata_thread subroutine retrieves the current Performance Monitor data for a target thread, and the accumulated time (timebase, PURR time and SPURR time) the events were counted.
The Performance Monitor data is always a set (one per hardware counter on the machine used) of 64-bit values.
Parameters
| Item | Description |
|---|---|
| pid | Process identifier of a target thread. The target process must be a debuggee of the caller process. |
| tid | Thread identifier of a target thread. |
| *pmdata | Pointer to a structure to return the Performance Monitor data for the target kernel thread. |
| *time | Pointer to a structure containing the timebase value the last time the hardware Performance Monitoring counters were read. This can be converted to time using the time_base_to_time subroutine. |
| *times | Pointer to a structure containing the accumulated time (timebase, PURR time and SPURR time) the events were counted. Each time counter can be converted to time using the time_base_to_time subroutine. |
Return Values
| Item | Description |
|---|---|
| 0 | No errors occurred. |
| Positive error code | Refer to the pm_error Subroutine to decode the error code. |
Error Codes
Refer to the pm_error Subroutine.
Files
| Item | Description |
|---|---|
| /usr/include/pmapi.h | Defines standard macros, data types, and subroutines. |