pm_get_data_pthread_mx or pm_get_tdata_pthread_mx Subroutine
Purpose
Returns Performance Monitor data in counter multiplexing mode for a target pthread.
Library
Performance Monitor APIs Library (libpmapi.a)
Syntax
#include <pmapi.h>
int pm_get_data_pthread_mx (pid, tid, ptid, *pmdata)
pid_t pid;
tid_t tid;
ptid_t ptid;
pm_data_mx_t *pmdata;
int pm_get_tdata_pthread_mx (pid, tid, ptid, *pmdata, *time)
pid_t pid;
tid_t tid;
ptid_t ptid;
pm_data_mx_t *pmdata;
timebasestruct_t *time;
Description
The pm_get_data_pthread_mx subroutine retrieves the current Performance Monitor data in counter multiplexing mode for a target pthread. The pthread must be stopped and must be part of a debuggee process under the control of a calling process.
The pm_get_tdata_pthread_mx subroutine retrieves the current Performance Monitor data in counter multiplexing mode for a target pthread, and a timestamp indicating the last time the hardware counters were read.
If the pthread is running in 1:1 mode, only the tid parameter must be specified. If the pthread is running in m:n mode, only the ptid parameter must be specified. If both the ptid and tid parameters are specified, they must be referring to a single pthread with the ptid parameter specified and currently running on a kernel thread with specified tid parameter.
The Performance Monitor data is always an array of a set (one per hardware counter on the machine used) of 64-bit values.
The user application must free the array allocated to store accumulated counts and times ( the accu_set field of the pmdata parameter).
Parameters
| Item | Description |
|---|---|
| pid | Process ID of target pthread. Target process must be a debuggee of the caller process. |
| tid | Thread ID of target pthread. To ignore this parameter, set it to 0. |
| ptid | Pthread ID of the target pthread. To ignore this parameter, set it to 0. |
| *pmdata | Pointer to a structure to return the Performance Monitor data (array of accumulated counters, accumulated time and accumulated PURR and SPURR time for each event set counted) for the target pthread. |
| *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. |
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. |