Subroutine pm_stop_pthread und pm_tstop_pthread

Zweck

Stoppt die Leistungsmonitorzählung für einen Ziel-pthread.

Bibliothek

Performance Monitor APIs Library (libpmapi.a)

Syntax

#include <pmapi.h> int pm_stop_pthread ( pid, tid, ptid) pid_t pid; tid_t tid; ptid_t ptid; int pm_tstop_pthread ( pid, tid, ptid, *time) pid_t pid; tid_t tid; ptid_t ptid; timebasestruct_t *time;

Beschreibung

Die Subroutine pm_stop_pthread stoppt die Leistungsmonitorzählung für einen Ziel-pthread. Der pthread muss gestoppt werden und Teil eines Debuggee-Prozesses unter der Steuerung des aufrufenden Prozesses sein.

Die Subroutine pm_tstop_pthread stoppt die Systemmonitorzählung für einen Ziel-pthread und gibt eine Zeitmarke zurück, die angibt, wann die Zählung gestoppt wurde.

Wenn der pthread im Modus 1: 1 ausgeführt wird, muss nur der Parameter tid angegeben werden. Wenn der pthread im Modus m: n ausgeführt wird, darf nur der Parameter ptid angegeben werden. Wenn die Parameter ptid und tid angegeben sind, müssen sie auf einen einzelnen pthread mit dem angegebenen Parameter ptid verweisen und derzeit in einem Kernel-Thread mit dem angegebenen Parameter tid ausgeführt werden.

Parameter

Element	Beschreibung
pid	Prozess-ID des Ziel-pthread. Der Zielprozess muss ein Debuggee des aufrufenden Prozesses sein.
TID	Thread-ID des Ziel-pthread. Um diesen Parameter zu ignorieren, setzen Sie ihn auf 0.
ptid	Pthread-ID des Ziel-pthread. Um diesen Parameter zu ignorieren, setzen Sie ihn auf 0.
*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.