Sous-routine perfstat_thread_util
Objectif
Calcule les métriques d'utilisation des unités d'exécution.
Bibliothèque
Bibliothèque Perfstat (libperfstat.a)
Syntaxe
#include <libperfstat.h>
int perfstat_thread_util (data,userbuff,sizeof_userbuff,desired_number)
perfstat_rawdata_t* data;
perfstat_thread_t* userbuff;
int sizeof_userbuff;
int desired_number;Descriptif
La sous-routine perfstat_thread_util fournit l'interface pour les métriques d'utilisation des unités d'exécution. La sous-routine perfstat_thread extrait une ou plusieurs statistiques d'unité d'exécution du noyau pour remplir la structure de données perfstat_thread_t . La sous-routine perfstat_thread_util utilise les valeurs en cours et précédentes pour calculer les métriques d'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 en cours de la structure de données perfstat_thread_t est renvoyée.
Si le paramètre desired_number est défini sur 0, le nombre d'éléments en cours de la structure de données perfstat_rawdata_t est renvoyé.
Paramètres
| Article | Descriptif |
|---|---|
| Données | Indique que le paramètre de données est de type perfstat_rawdata_t. La structure de données perfstat_rawdata_t utilise les valeurs en cours et précédentes pour calculer les métriques d'utilisation. |
| buff utilisateur | Pointe vers la zone de mémoire remplie avec une ou plusieurs structures de données perfstat_thread_t . |
| taille_utilisateur_tampon | Indique la taille de la structure de données perfstat_thread_t . Remarque: Pour obtenir la taille de la dernière version de la structure de données perfstat_thread_t , définissez le paramètre sizeof_userbuff sur 0 et le paramètre name et userbuff sur NULL.
|
| numéro_desired_ | Indique le nombre de structures de données perfstat_thread_t à copier dans le paramètre userbuff . |
Valeurs renvoyées
A moins que la sous-routine perfstat_thread_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 é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.