perfstat_cpu_total_wpar, Subroutine

Online bearbeiten

Zweck

Ruft Prozessornutzungsstatistiken für Workloadpartition (WPAR) ab.

Bibliothek

Perfstat-bibliothek (libperfstat.a)

Syntax

#include <libperfstat.h>

int perfstat_cpu_total_wpar ( name, userbuff, sizeof_userbuff, desired_number )
perfstat_id_wpar_t *name;
perfstat_cpu_total_wpar_t *userbuff;
size_t sizeof_userbuff;
int desired_number;

Beschreibung

Die Subroutine perfstat_cpu_total_wpar gibt Prozessornutzungsstatistiken für die Workloadpartition (WPAR) in einer perfstat_cpu_total_wpar_t-Struktur zurück.

Zum Abrufen von Statistiken einer bestimmten WPAR aus der globalen Umgebung muss die WPAR -ID oder der WPAR -Name im Parameter Name angegeben werden. Der Parameter userbuff muss zugeordnet und der Parameter desired_number muss auf den Wert 1 gesetzt werden. Wenn diese Subroutine innerhalb einer WPARaufgerufen wird, muss der Parameter name auf NULL gesetzt werden.

Parameter

Element Beschreibung
Name Gibt die WPAR -ID oder den WPAR -Namen an. Sie ist NULL, wenn die Subroutine von WPARaufgerufen wird.
Benutzerbuff Verweist auf den Speicherbereich, der mit der Struktur perfstat_cpu_total_wpar_t gefüllt werden soll
Größe des Benutzerbuffs Gibt die Größe der Struktur perfstat_cpu_total_wpar_t an.
desired_number Gibt die Anzahl der zurückzugebenden Strukturen an. Der Wert dieses Parameters muss auf 1 gesetzt werden.

Rückgabewerte

Nach erfolgreichem Abschluss wird die Anzahl der gefüllten Strukturen zurückgegeben. Wenn dies nicht gelingt, wird der Wert -1 zurückgegeben, und die globale Variable errno wird gesetzt.

Fehlercodes

Die Subroutine perfstat_cpu_total_wpar ist nicht erfolgreich, wenn eine der folgenden Bedingungen zutrifft:

Element Beschreibung
EINVAL Einer der Parameter ist ungültig.
EFAULT Der Speicher ist nicht ausreichend.
ENOMEM Die Standardlänge der Zeichenfolge ist zu kurz.

Dateien

Die Datei libperfstat.h definiert Standardmakros, -datentypen und -subroutinen.