sous-routine perfstat_processor_pool_util

Objectif

Calcule les métriques liées à l'utilisation du pool de traitement.

Bibliothèque

perfstat library (libperfstat.a)

Syntaxe

#include <libperfstat.h>

int perfstat_processor_pool_util (perfstat_rawdata_t * data ,perfstat_processor_pool_util_t * userbuff
int sizeoff_userbuff,
int desired_number);

Descriptif

La sous-routine perfstat_processor_pool_util calcule les métriques liées à l'utilisation du pool de traitement pour les valeurs en cours et précédentes transmises à la structure de données perfstat_rawdata_t .

L'utilisation du pool est calculée en spécifiant la zone Type de la structure de données perfstat_rawdata_t dans SHARED_POOL_UTIL. SHARED_POOL_UTIL est une macro à laquelle il peut être fait référence dans la définition de la structure de données perfstat_rawdata_t .

Paramètres

données: Calcule les métriques liées à l'utilisation du pool de traitement à partir des valeurs en cours et précédentes.
Le paramètre data appartient au type de structure de données perfstat_rawdata_t . Les attributs curstat et prevstat pointent vers la structure de données perfstat_partition_total .
Userbuff: Indique la zone de mémoire à remplir avec une ou plusieurs structures perfstat_processor_util_t .
taille du tampon utilisateur: Indique la taille de la structure perfstat_processor_util_t .
numéro_desired_: Indique le nombre de structures perfstat_processor_util_t à copier dans le paramètre userbuff . La valeur doit être définie sur 1.

Codes d'erreur

La sous-routine perfstat_processor_pool_util échoue si la condition suivante est vérifiée:

EINVAL: La valeur est définie si l'un des paramètres n'est pas valide.
EPERM: La valeur est définie si la collecte des données de performances n'est pas activée.

Valeurs renvoyées

Si le paramètre data est défini sur NULL et que le paramètre userbuff est également défini sur NULL et que le paramètre sizeof_userbuff est défini sur 0, la taille de la sous-routine perfstat_processor_pool_util_t est renvoyée.

A moins que la sous-routine perfstat_processor_pool_util ne soit utilisée pour extraire le nombre de structures disponibles, le nombre de structures remplies est renvoyé lorsque l'opération aboutit. Sinon, la valeur -1 est renvoyée et la variable globale errno est définie.

Remarque: La sous-routine perfstat_processor_pool_util requiert l'activation de la collecte des données de performances pour renvoyer les valeurs du pool de traitement.