pm_get_program_mygroup Subroutine

Zweck

Ruft die Leistungsüberwachungseinstellungen für die Zählgruppe ab, zu der der aufrufende Thread gehört.

Bibliothek

Performance Monitor APIs Library (libpmapi.a)

Syntax

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

Beschreibung

Die Subroutine pm_get_program_mygroup ruft die Leistungsüberwachungseinstellungen für die Zählgruppe ab, zu der der aufrufende Kernel-Thread gehört. Dazu gehören Modusinformationen und die zu zählenden Ereignisse, die in einer Liste von Ereignis-IDs enthalten sind. Die IDs stammen aus den von der Subroutine pm_init zurückgegebenen Listen.

Der Zählmodus umfasst den Benutzermodus und den Kernelmodus sowie den aktuellen Zählstatus.

Wenn die Liste ein Ereignis enthält, das mit einem Schwellenwert verwendet werden kann (wie durch die Subroutine pm_init angegeben), wird ebenfalls ein Schwellenwert zurückgegeben.

Parameter

Element	Beschreibung
* prog	Gibt zurück, welche Leistungsmonitorereignisse und -modi festgelegt sind. Folgende Modi werden unterstützt: PM_USER Im Benutzermodus ausgeführte Prozesse zählen PM_KERNEL Im Kernelmodus ausgeführte Prozesse zählen PM_COUNT Zählung ist aktiviert Prozess PM_PROCESS Zählgruppe auf Prozessebene

Rückgabewerte

Element	Beschreibung
0	Es sind keine Fehler aufgetreten.
Positiver Fehlercode	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.