Technical Reference: Base Operating System and Extensions, Volume 1

pm_get_data_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;

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 data is a set (one per hardware counter on the machine used) of 64-bit values.

Parameters

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.

Return Values

0	No errors occurred.
Positive error code	Refer to the pm_error (pm_error Subroutine) subroutine to decode the error code.

Error Codes

Refer to the pm_error (pm_error Subroutine) subroutine.

Files

/usr/include/pmapi.h

Defines standard macros, data types, and subroutines.

Related Information

pm_init (pm_init Subroutine), pm_error (pm_error Subroutine), pm_set_program_thread (pm_set_program_thread Subroutine), pm_get_program_thread (pm_get_program_thread Subroutine), pm_get_data_thread (pm_get_data_thread Subroutine), pm_start_thread (pm_start_thread Subroutine), pm_stop_thread (pm_stop_thread Subroutine), pm_reset_data_thread (pm_reset_data_thread Subroutine) subroutines.

Performance Monitor API Programming Concepts in AIX 5L Version 5.1 General Programming Concepts.