Stops Performance Monitor counting for the group to which a target pthread belongs.
Performance Monitor APIs Library (libpmapi.a)
The pm_stop_pgroup subroutine stops Performance Monitor counting for a target pthread, the counting group to which it belongs, and all the other pthread members of the same group. Counting stops immediately for all the pthreads in the counting group. The target pthread must be stopped and must be part of a debuggee process, under control of the calling process.
The pm_tstop_pgroup subroutine stops Performance Monitor counting for a target pthread, the counting group to which it belongs, and all the other pthread members of the same group, and returns a timestamp indicating when the counting was stopped.
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. |
| *time | Pointer to a structure containing the timebase value when the counting was stopped. This can be converted to time using the time_base_to_time subroutine. |
| 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. |