Resets Performance Monitor data for a target pthread and the counting group to which it belongs.
Performance Monitor APIs Library (libpmapi.a)
The pm_reset_data_pgroup subroutine resets the current Performance Monitor data for a target pthread and the counting group to which it belongs. The pthread 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 pthreads in the group is not affected, the group is marked as inconsistent unless it has only one member.
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.
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. |
Item | Description |
---|---|
0 | Operation completed successfully. |
Positive error code | Refer to the pm_error Subroutine to decode the error code. |
Refer to the pm_error Subroutine.
Item | Description |
---|---|
/usr/include/pmapi.h | Defines standard macros, data types, and subroutines. |