pm_get_program_wp Subroutine

Online bearbeiten

Zweck

Ruft die systemweite Leistungsüberwachungseinstellung für eine angegebene Workloadpartition (WPAR) ab.

Bibliothek

Performance Monitor-API-Bibliothek (libpmapi.a)

Syntax

#include <pmapi.h> 
int pm_get_program_wp (cid, *prog)
cid_t cid;
pm_prog_t *prog;

Beschreibung

Die Subroutine pm_get_program_wp ruft systemweite Leistungsüberwachungseinstellungen für die Prozesse ab, die zur angegebenen Workloadpartitiongehören. Diese Einstellungen umfassen die Modusinformationen und die Ereignisse, die gezählt werden.

Die gezählten Ereignisse befinden sich in einer Liste von Ereignis-IDs. Die IDs müssen aus der Liste ausgewählt werden, die die Subroutine pm_init zurückgibt. Wenn die Liste ein Ereignis enthält, das mit einem Schwellenwert verwendet werden kann, können Sie einen Schwellenwert angeben.

Wenn die Ereignisse durch eine Gruppen-ID dargestellt werden, wird das Bit is_group im Modus gesetzt und das erste Element des Ereignisarrays enthält die Gruppen-ID. Die anderen Elemente des Ereignisarrays sind nicht aussagekräftig.

Der Zählmodus umfasst den Benutzermodus und/oder den Kernelmodus, den Anfangszählungsstatus und den Prozessbaummodus.

Wenn der Prozessbaummodus auf den Status On gesetzt ist, gilt die Zählung nur für den aufrufenden Prozess und seine untergeordneten Prozesse.

Parameter

Element Beschreibung
CID Gibt die ID der WPAR an, für die die Subroutine abgerufen werden soll Die CID kann mit dem Systemaufruf getcorralid aus dem Namen der WPAR abgerufen werden.
PROG Gibt die festgelegten Leistungsmonitorereignisse und -modi zurück. Die folgenden Modi werden unterstützt:
PM-BENUTZER
Die im Benutzermodus ausgeführten Prozesse werden gezählt.
PM_KERNEL
Die im Kernelmodus ausgeführten Prozesse werden gezählt.
PM_XX_ENCODE_CASE_ONE anzahl
Die Zählung ist aktiviert.
PM_PROZESSBAUM
Es werden nur der aufrufende Prozess und seine untergeordneten Prozesse gezählt.

Rückgabewerte

Element Beschreibung
0 Operation wurde erfolgreich beendet.
Positiver Fehlercode Führen Sie die Subroutine pm_error aus und decodieren Sie den Fehlercode.

Fehlercodes

Informationen zum Decodieren des Fehlercodes enthält die Subroutine pm_error .

Dateien

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