[ Previous | Next | Table of Contents | Index | Library Home | Legal | Search ]

Technical Reference: Base Operating System and Extensions, Volume 1


pm_start_thread Subroutine

Purpose

Starts Performance Monitor counting for a target thread.

Library

Performance Monitor APIs Library (libpmapi.a)

Syntax


#include <pmapi.h>


int pm_start_thread ( pid, tid)
pid_t pid;
tid_t tid;

Description

The pm_start_thread subroutine starts Performance Monitor counting 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. Counting is effective immediately unless the thread is in a group and the group counting is not currently set to On. The counting state of a thread in a group is obtained by ANDing the thread counting state with the group state.

Parameters


pid Process ID of target thread. Target process must be a debuggee of the caller process.
tid Thread ID of target thread.

Return Values


0 Operation completed successfully.
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


/usr/include/pmapi.h Defines standard macros, data types, and subroutines.

Related Information

The pm_init (pm_init Subroutine) subroutine, pm_error (pm_error Subroutine) subroutine, pm_set_program_thread (pm_set_program_thread Subroutine) subroutine, pm_get_program_thread (pm_get_program_thread Subroutine) subroutine, pm_delete_program_thread (pm_delete_program_thread Subroutine) subroutine, pm_get_data_thread (pm_get_data_thread Subroutine) subroutine, pm_stop_thread (pm_stop_thread Subroutine) subroutine, pm_reset_data_thread (pm_reset_data_thread Subroutine) subroutine.

Performance Monitor API Programming Concepts in AIX 5L Version 5.1 General Programming Concepts.


[ Previous | Next | Table of Contents | Index | Library Home | Legal | Search ]