pm_stop_mygroup and pm_tstop_mygroup Subroutine
Purpose
Stops Performance Monitor counting for the group to which the calling thread belongs.
Library
Performance Monitor APIs Library (libpmapi.a)
Syntax
#include <pmapi.h>
int pm_stop_mygroup ()
int pm_tstop_mygroup(*time)
timebasestruct_t *time;Description
The pm_stop_mygroup subroutine stops Performance Monitor counting for the group to which the calling kernel thread belongs. This is effective immediately for all the threads in the counting group.
The pm_tstop_mygroup subroutine stops Performance Monitor counting for the group to which the calling kernel thread belongs, and returns a timestamp indicating when the counting was stopped.
Parameters
| Item | Description |
|---|---|
| *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. |
Return Values
| Item | Description |
|---|---|
| 0 | Operation completed successfully. |
| Positive error code | Refer to the pm_error Subroutine to decode the error code. |
Error Codes
Refer to the pm_error Subroutine.
Files
| Item | Description |
|---|---|
| /usr/include/pmapi.h | Defines standard macros, data types, and subroutines. |