Sous-routine perfstat_virtual_fcadapter
Objectif
Extrait les statistiques d'utilisation de l'adaptateur NPIV (Virtual Fiber Channel Adapter).
Bibliothèque
Bibliothèque Perfstat (libperfstat.a)
Syntaxe
#include <libperfstat.h>
int perfstat_virtual_fcadapter (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_virtual_fcadapter extrait une ou plusieurs statistiques d'utilisation de l'adaptateur NPIV (Virtual Fiber Channel Adapter).
La même fonction peut également être utilisée pour extraire le nombre d'ensembles disponibles de statistiques d'utilisation de l'adaptateur NPIV (Virtual Fiber Channel Adapter).
Pour obtenir un ou plusieurs ensembles de métriques d'utilisation de l'adaptateur FC virtuel (NPIV), définissez le paramètre name sur le nom du premier adaptateur FC virtuel pour lequel les statistiques doivent être collectées et définissez le paramètre desired_number . Pour démarrer à partir du premier adaptateur FC virtuel, définissez le paramètre name entre guillemets ("") ou FIRST_VFCHOST. Le paramètre userbuff doit toujours pointer vers la zone de mémoire suffisamment grande pour contenir le nombre de structures perfstat_fcstat_t que cette sous-routine doit copier. A son retour, le paramètre name est défini sur le nom de l'adaptateur FC suivant ou sur les guillemets ("") après la copie de toutes les structures.
Pour extraire le nombre d'ensembles disponibles de métriques d'utilisation de l'adaptateur FC virtuel, définissez le paramètre name et le paramètre userbuff sur la valeur null, et le paramètre desired_number sur la valeur zéro. La valeur renvoyée correspond au nombre d'ensembles disponibles.
Paramètres
| Article | Descriptif |
|---|---|
| nom | Contient les guillemets (""), FIRST_VFCHOST, ou le nom indiquant le premier adaptateur FC pour lequel les statistiques doivent être extraites. Par exemple: vfchost0, vfchost1. |
| buff utilisateur | Pointe vers la mémoire à remplir 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 paramètre userbuff . |
Valeurs renvoyées
Une fois l'opération terminée, le nombre de structures remplies est renvoyé.
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_virtual_fcadapter échoue si l'une des conditions suivantes est vraie:
| 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 | Le dictionnaire n'est pas accessible. |
Fichiers
Le fichier libperfstat.h définit les macros standard, les types de données et les sous-routines.