pm_reset_data_group Subroutine
Purpose
Resets Performance Monitor data for a target thread and the counting group to which it belongs.
Library
Performance Monitor APIs Library (libpmapi.a)
Syntax
Description
This subroutine supports only the 1:1 threading model. It has been superseded by the pm_reset_data_pgroup subroutine, which supports both the 1:1 and the M:N threading models. A call to this subroutine is equivalent to a call to the pm_reset_data_pgroup subroutine with a ptid parameter equal to 0.
The pm_reset_data_group subroutine resets the current Performance Monitor data for a target kernel thread and the counting group to which it belongs. The thread must be stopped and must be part of a debugee process, under control of the calling process. The data is a set (one per hardware counter on the machine used) of 64-bit values. All values are reset to 0. Because the data for all the other threads in the group is not affected, the group is marked as inconsistent unless it has only one member.
Parameters
| Item | Description |
|---|---|
| pid | Process ID of target thread. Target process must be a debuggee of the caller process. |
| tid | Thread ID of target thread. |
Return Values
| Item | Description |
|---|---|
| 0 | Operation completed successfully. |
| 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
| Item | Description |
|---|---|
| /usr/include/pmapi.h | Defines standard macros, data types, and subroutines. |