pm_set_program_mythread Subroutine

Zweck

Legt die Performance Monitor-Programmierung für den aufrufenden Thread fest.

Bibliothek

Leistungsüberwachungs-APIs-Bibliotheklibpmapi.a)

Syntax

#include <pmapi.h> int pm_set_program_mythread ( *prog) pm_prog_t *prog;

Beschreibung

Die Unterroutine pm_set_program_mythread setzt die Performance-Monitor-Programmierung für den aufrufenden Kernel-Thread. Die Einstellung enthält die zu zählenden Ereignisse und einen Modus, in dem gezählt werden kann. Die zu zählenden Ereignisse befinden sich in einer Liste von Ereignis-IDs. Die Bezeichner müssen aus den vom Unterprogramm pm_init zurückgegebenen Listen ausgewählt werden.

Der Zählmodus umfasst den Benutzermodus und/oder den Kernelmodus sowie den Anfangszählungsstatus. Die Standardeinstellungen sind für den Benutzermodus und den Kernelmodus auf "Aus" gesetzt, und der anfängliche Standardzustand ist so eingestellt, dass die Zählung verzögert wird, bis die Unterroutine pm_start_mythread aufgerufen wird.

Enthält die Liste ein Ereignis, das mit einem Schwellenwert verwendet werden kann (wie in der Unterroutine pm_init angegeben), kann auch ein Schwellenwert angegeben werden.

Parameter

Element	Beschreibung
* prog	Gibt die Ereignismodi an, die in der Performance Monitor-Konfiguration verwendet werden. Die folgenden Modi werden unterstützt: PM-BENUTZER Zählt Prozesse, die im Benutzermodus ausgeführt werden (Standardeinstellung ist 'Aus') PM_KERNEL Zählt Prozesse, die im Kernelmodus ausgeführt werden (Standardeinstellung ist 'Aus') PM_XX_ENCODE_CASE_ONE anzahl Beginnt sofort mit der Zählung (Standardeinstellung ist "Nicht mit der Zählung beginnen") PM_PROCESS (Prozess) Erstellt eine Zählgruppe auf Prozessebene

Element

Beschreibung

* prog

Gibt die Ereignismodi an, die in der Performance Monitor-Konfiguration verwendet werden. Die folgenden Modi werden unterstützt:

PM-BENUTZER: Zählt Prozesse, die im Benutzermodus ausgeführt werden (Standardeinstellung ist 'Aus')
PM_KERNEL: Zählt Prozesse, die im Kernelmodus ausgeführt werden (Standardeinstellung ist 'Aus')
PM_XX_ENCODE_CASE_ONE anzahl: Beginnt sofort mit der Zählung (Standardeinstellung ist "Nicht mit der Zählung beginnen")
PM_PROCESS (Prozess): Erstellt eine Zählgruppe auf Prozessebene

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.