pm_reset_data_thread Subroutine

Purpose

Resets Performance Monitor data for a target thread.

Library

Performance Monitor APIs Library (libpmapi.a)

Syntax

#include <pmapi.h> int pm_reset_data_thread ( pid, tid) pid_t pid; tid_t tid;

Description

This subroutine supports only the 1:1 threading model. It has been superseded by the pm_reset_data_pthread 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_reset_data_pthread subroutine with a ptid parameter equal to 0.

The pm_reset_data_thread subroutine resets the current Performance Monitor data for a target kernel thread. The thread must be stopped and must be part of a debuggee process. The data is a set (one per hardware counter on the machine used) of 64-bit values. All values are reset to 0.

Parameters

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

Return Values

Item	Description
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

Item	Description
/usr/include/pmapi.h	Defines standard macros, datatypes, and subroutines.