Subroutine pm_stop_thread und pm_tstop_thread

Zweck

Stoppt die Leistungsmonitorzählung für einen Zielthread.

Bibliothek

Performance Monitor APIs Library (libpmapi.a)

Syntax

#include <pmapi.h> int pm_stop_thread (pid, tid) pid_t pid; tid_t tid; int pm_tstop_thread (pid, tid, *time) pid_t pid; tid_t tid; timebasestruct_t *time;

Beschreibung

Diese Subroutine unterstützt nur das 1:1-Threading-Modell. Sie wurde durch die Subroutine pm_stop_pthread ersetzt, die sowohl das Threading-Modell 1: 1 als auch das Threading-Modell M: N unterstützt. Ein Aufruf dieser Subroutine entspricht einem Aufruf der Subroutine pm_stop_pthread mit einem Parameter ptid gleich 0.

Die Subroutine pm_stop_thread stoppt die Performance Monitor-Zählung für einen Zielkernel-Thread. Der Thread muss gestoppt werden und Teil eines Debuggee-Prozesses sein, der vom aufrufenden Prozess gesteuert wird.

Die Subroutine pm_tstop_thread stoppt die Leistungsmonitorzählung für einen Zielkernel-Thread und gibt eine Zeitmarke zurück, die angibt, wann die Zählung gestoppt wurde.

Parameter

Element	Beschreibung
pid	Prozess-ID des Zielthreads. Der Zielprozess muss ein Debuggee des aufrufenden Prozesses sein.
TID	Thread-ID des Zielthreads.
*TIME	Zeiger auf eine Struktur, die den Zeitbasiswert enthält, als die Zählung gestoppt wurde. Dies kann mit der Subroutine time_base_to_time in Zeit konvertiert werden.

Rückgabewerte

Element	Beschreibung
0	Operation wurde erfolgreich beendet.
Positive error code	Verwenden Sie die Subroutine pm_error , um den Fehlercode zu decodieren.

Fehlercodes

Weitere Informationen finden Sie in der Beschreibung der Subroutine pm_error.

Dateien

Element	Beschreibung
/usr/include/pmapi.h	Definiert Standardmakros, Datentypen und Subroutinen.