pm_delete_program_group Subroutine
Purpose
Deletes previously established Performance Monitor settings for the counting group to which a target thread 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_delete_program_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_delete_program_pgroup subroutine with a ptid parameter equal to 0.
The pm_delete_program_group subroutine deletes previously established Performance Monitor settings for a target kernel thread. The thread must be stopped and must be part of a debuggee process under the control of the calling process. The settings for the group to which the target thread belongs and from all the other threads in the same group are also deleted.
Parameters
| Item | Description |
|---|---|
| pid | Process identifier of target thread. The target process must be a debuggee under the control of the calling process. |
| tid | Thread identifier of a target thread. |
Return Values
| Item | Description |
|---|---|
| 0 | No errors occurred. |
| 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. |