Sous-routine perfstat_fcstat
Objectif
Extrait les statistiques d'un adaptateur FC (Fibre Channel).
Bibliothèque
Bibliothèque Perfstat (libperfstat.a)
Syntaxe
#include <libperfstat.h>
int perfstat_fcstat (name, userbuff, sizeof_struct, desired_number)
perfstat_id_t *name;
perfstat_fcstat_t *userbuff;
size_t sizeof_struct;
int desired_number;
Descriptif
La sous-routine perfstat_fcstat extrait les statistiques d'une ou de plusieurs cartes FC. La même fonction est également utilisée pour extraire le nombre de statistiques d'adaptateur FC disponibles.
Pour obtenir une ou plusieurs statistiques d'adaptateur FC, indiquez le nom du premier adaptateur FC pour lequel vous souhaitez obtenir les statistiques à l'aide du paramètre name et définissez le paramètre desired_number en conséquence. Pour démarrer à partir de la première carte FC, définissez le paramètre name sur "" ou FIRST_FCADAPTER. Le paramètre userbuff pointe toujours vers une zone de mémoire pouvant contenir le nombre souhaité de structures perfstat_fcstat_t copiées par cette fonction. Une fois la sous-routine terminée, le paramètre name est défini sur le nom de l'adaptateur FC suivant ou sur "" une fois que toutes les structures ont été copiées.
Pour extraire le nombre de statistiques d'adaptateur FC disponibles, définissez les paramètres name et userbuff sur NULLet le paramètre desired_number sur 0. La valeur renvoyée correspond au nombre d'adaptateurs disponibles.
Pour l'utilisateur non root, les valeurs renvoyées par la sous-routine perfstat_fcstat seront toujours égales à zéro pour tous les adaptateurs Fibre Channel répertoriés.
Paramètres
| Article | Descriptif |
|---|---|
| nom | Indique "" ou FIRST_FCADAPTER, ou le nom du premier adaptateur de réseau pour lequel des statistiques sont requises. Par exemple, fcs0 ou fcs1. |
| buff utilisateur | Pointe vers la zone de mémoire qui doit être remplie avec une ou plusieurs structures perfstat_fcstat_t . |
| taille_struct | Indique la taille de la structure perfstat_fcstat_t . |
| numéro_desired_ | Indique le nombre de structures perfstat_fcstat_t à copier dans le pointeur userbuff . |
Valeurs renvoyées
Une fois la sous-routine terminée, sauf si la fonction est utilisée pour extraire le nombre de structures disponibles, le nombre de structures remplies est renvoyé. Si la sous-routine échoue, la valeur -1 est renvoyée et la variable globale errno est définie.
Codes d'erreur
La sous-routine échoue si l'une des conditions suivantes est vérifiée:
| Article | Descriptif |
|---|---|
| EINVAL | L'un des paramètres n'est pas valide. |
| EFAULT | La mémoire est insuffisante. |
| ENOMEM | La longueur par défaut de la chaîne est trop courte. |
| ENOMSG | Impossible d'accéder au dictionnaire. |
Fichiers
Le fichier libperfstat.h définit les macros standard, les types de données et les sous-routines.