Sous-routine perfstat_cpu_util
Objectif
Calcule l'utilisation de l'unité centrale.
Bibliothèque
Bibliothèque perfstat (libperfstat.a)
Syntaxe
#include <libperfstat.h>int perfstat_cpu_util (cpustats, userbuff, sizeof_userbuff, desired_number)
perfstat_rawdata_t * cpustats;
perfstat_cpu_util_t * userbuff;
int sizeof_userbuff ;
int desired_number ;Descriptif
La sous-routine perfstat_cpu_util calcule les métriques liées à l'utilisation de l'UC pour les valeurs en cours et précédentes transmises à la structure de données perfstat_rawdata_t . Les valeurs d'utilisation du système et d'utilisation par unité centrale peuvent être obtenues, à l'aide de la même API, en mentionnant la zone de type de la structure de données perfstat_rawdata_t comme UTIL_CPU_TOTAL ou UTIL_CPU. Les macros UTIL_CPU_TOTAL et UTIL_CPU peuvent être référencées dans la définition de la structure de données perfstat_rawdata_t . Si les attributs name et userbuff sont définis sur NULL et que le paramètre sizeof_userbuff est défini sur zéro, la taille de la version en cours de la structure perfstat_cpu_util_t est renvoyée. Si le paramètre desired_elements est défini sur zéro, le nombre d'éléments en cours, à partir du paramètre cpustats , est renvoyé.
Paramètres
| Article | Descriptif |
|---|---|
| cpustats | Calcule les métriques liées à l'utilisation à partir des valeurs en cours et précédentes. Le paramètre cpustats est de type perfstat_rawdata_t. Les attributs curstat et prevstat pointent vers la structure de données perfstat_cpu_util_t . Remarque: Pour calculer l'utilisation de l'UC au niveau de la partition, définissez le paramètre cpustats sur UTIL_CPU_TOTAL . Pour l'utilisation de l'UC individuelle, définissez le paramètre cpustats sur UTIL_CPU. L'ID de l'unité centrale individuelle peut également être spécifié dans le paramètre cpustats si l'utilisation à calculer s'applique uniquement à une unité centrale spécifique.
|
| buff utilisateur | Indique la zone de mémoire à remplir avec une ou plusieurs structures perfstat_cpu_util_t . |
| taille_utilisateur_tampon | Indique la taille de la structure perfstat_cpu_util_t . Remarque: Pour obtenir la taille de la dernière version de la structure perfstat_cpu_util_t , définissez le paramètre sizeof_userbuff sur 0 et définissez les paramètres name et userbuff sur NULL.
|
| numéro_desired_ | Indique le nombre de structures perfstat_cpu_util_t à copier dans le paramètre userbuff . |
Valeurs renvoyées
A moins que la sous-routine perfstat_cpu_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_cpu_util échoue si les conditions suivantes sont remplies:
| 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.