pm_set_program_mygroup Subroutine

Online bearbeiten

Zweck

Legt die Performance Monitor-Programmierung für den aufrufenden Thread fest und erstellt eine Zählgruppe.

Bibliothek

Leistungsüberwachungs-APIs-Bibliotheklibpmapi.a)

Syntax

#include <pmapi.h>

int pm_set_program_mygroup ( *prog)
pm_prog_t *prog;

Beschreibung

Die Unterroutine pm_set_program_mygroup legt die Performance-Monitor-Programmierung für den aufrufenden Kernel-Thread fest. 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.

Dieser Aufruf erstellt auch eine Zählgruppe, die den aufrufenden Thread und jeden Thread enthält, den er oder einer seiner Nachkommen in der Zukunft erstellen wird. Optional kann die Gruppe so definiert werden, dass sie auch alle vorhandenen und zukünftigen Threads enthält, die zum aufrufenden Prozess gehören.

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_mygroup 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 Ereignisse und den Modus an, die bei der Einrichtung des Leistungsmonitors verwendet werden sollen. 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.