Sous-routine perfstat_process_util
Objectif
Calcule les métriques d'utilisation des processus.
Bibliothèque
bibliothèque perfstat (libperfstat.a)
Syntaxe
#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 ;Descriptif
La sous-routine perfstat_process_util fournit l'interface pour les métriques d'utilisation des processus. La sous-routine perfstat_process extrait une ou plusieurs statistiques de processus pour remplir la structure de données perfstat_process_t . La sous-routine perfstat_process_util utilise les valeurs en cours et précédentes pour calculer les métriques liées à l'utilisation. Si les paramètres name et userbuff sont définis sur NULL et que le paramètre sizeof_userbuff est défini sur 0, la taille de la version actuelle de la structure de données perfstat_process_t est renvoyée. Si le paramètre desired_number est défini sur 0, le nombre d'éléments en cours, à partir de la structure de données perfstat_rawdata_t , est renvoyé.
Paramètres
| Article | Descriptif |
|---|---|
| Données | Indique que le paramètre data est de type |
| buff utilisateur | Indique la zone de mémoire à remplir avec une ou plusieurs structures de données |
| taille_utilisateur_tampon | Indique la taille de la structure de données Remarque: Pour obtenir la taille de la dernière version de la structure de données
perfstat_process_t, définissez le paramètre sizeof_userbuff sur 0 et les paramètres name et userbuff sur NULL. |
| numéro_desired_ | Indique le nombre de structures |
Valeurs renvoyées
A moins que la sous-routine perfstat_process_util ne soit utilisée pour extraire le nombre de structures disponibles, le nombre de structures remplies est renvoyé lorsque l'opération aboutit. En cas d'échec, la valeur -1 est renvoyée et la variable globale errno est définie.
Codes d'erreur
La sous-routine perfstat_process_util échoue si le code d'erreur suivant est true:
| Article | Descriptif |
|---|---|
EINVAL |
L'un des paramètres n'est pas valide. |
Fichiers
Le fichier libperfstat.h définit les macros standard, les types de données et les sous-routines.