perfstat_process_util (Subroutine)

Online bearbeiten

Zweck

Berechnet die Prozessnutzungsmetriken.

Bibliothek

perfstat-Bibliotheklibperfstat.a)

Syntax

#include <libperfstat.h>
int perfstat_process (data, userbuff, sizeof_userbuff, desired_number)
perfstat_id_t * data;
perfstat_process_t * userbuff;
int sizeof_userbuff ;
int desired_number ;

Beschreibung

Das Unterprogramm perfstat_process_util stellt die Schnittstelle für Prozessauslastungsmetriken bereit. Das Unterprogramm perfstat_process ruft eine oder mehrere Prozessstatistiken ab, um die Datenstruktur perfstat_process_t zu füllen. Das Unterprogramm perfstat_process_util verwendet die aktuellen und vorherigen Werte, um die auslastungsbezogenen Metriken zu berechnen. Wenn die Parameter name und userbuff auf NULL gesetzt sind und der Parameter sizeof_userbuff auf 0 gesetzt ist, wird die Größe der aktuellen Version der Datenstruktur perfstat_process_t zurückgegeben. Wenn der Parameter desired_number auf 0 gesetzt ist, wird die Anzahl der aktuellen Elemente aus der Datenstruktur perfstat_rawdata_t zurückgegeben.

Parameter

Element Beschreibung
data

Gibt an, dass der Datenparameter vom Typ perfstat_rawdata_t ist. Die Datenstruktur perfstat_rawdata_t kann den aktuellen und den vorherigen Wert zur Berechnung der auslastungsbezogenen Metriken verwenden.
Benutzerbuff

Gibt den Speicherbereich an, der mit einer oder mehreren perfstat_process_t-Datenstrukturen gefüllt werden soll.
Größe des Benutzerbuffs

Gibt die Größe der Datenstruktur perfstat_process_t an.

Hinweis: Um die Größe der letzten Version der Datenstruktur perfstat_process_t zu erhalten, setzen Sie den Parameter sizeof_userbuff auf 0 und die Parameter name und userbuff auf NULL.
desired_number

Gibt die Anzahl der perfstat_process_t-Strukturen an, die in den userbuff-Parameter kopiert werden sollen.

Rückgabewerte

Sofern nicht das Unterprogramm perfstat_process_util verwendet wird, um die Anzahl der verfügbaren Strukturen abzurufen, wird nach erfolgreichem Abschluss die Anzahl der gefüllten Strukturen zurückgegeben. Wenn dies nicht gelingt, wird ein Wert von -1 zurückgegeben und die globale Variable errno wird gesetzt.

Fehlercodes

Die Unterroutine perfstat_process_util ist nicht erfolgreich, wenn der folgende Fehlercode zutrifft:

Element Beschreibung
EINVAL Einer der Parameter ist ungültig.

Dateien

Die Datei libperfstat.h definiert Standardmakros, Datentypen und Unterroutinen.