Stops Performance Monitor counting for a target pthread.
Performance Monitor APIs Library (libpmapi.a)
The pm_stop_pthread subroutine stops Performance Monitor counting for a target pthread. The pthread must be stopped and must be part of a debuggee process, under the control of the calling process.
The pm_tstop_pthread subroutine stops Performance Monitor counting for a target pthread, 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. |