Sous-routine perfstat_virtualdiskadapter
Objectif
Extrait les statistiques d'utilisation des adaptateurs SCSI (Virtual Small Computer System Interface) ou SAS (Serial Attached SCSI) dans Virtual I/O Server (VIOS).
Bibliothèque
Bibliothèque Perfstat (libperfstat.a)
Syntaxe
#include <libperfstat.h>
int perfstat_virtualdiskadapter (name, userbuff, sizeof_struct, desired_number)
perfstat_id_t * name;
perfstat_diskadapter_t * userbuff;
size_t sizeof_struct;int desired_number;Descriptif
La sous-routine perfstat_virtualdiskadapter extrait une ou plusieurs statistiques d'utilisation de l'adaptateur SCSI/SAS virtuel.
La même fonction peut également être utilisée pour extraire le nombre d'ensembles disponibles de statistiques d'adaptateur VHOST (Virtual SCSI/SAS).
Pour obtenir un ou plusieurs ensembles de métriques d'utilisation de l'interface SCSI virtuelle, définissez le paramètre name sur le nom du premier adaptateur SCSI virtuel pour lequel les statistiques doivent être collectées et définissez le paramètre desired_number . Pour démarrer à partir du premier adaptateur SCSI virtuel, définissez le paramètre name entre guillemets ("") ou FIRST_VHOST. Le paramètre userbuff doit toujours pointer vers la zone de mémoire suffisamment grande pour contenir le nombre de structures perfstat_diskadapter_t que cette sous-routine doit copier. A son retour, le paramètre name est défini sur le nom de l'adaptateur de réseau suivant, entre guillemets ("") après la copie de toutes les structures.
Pour extraire le nombre d'ensembles disponibles de métriques d'utilisation de l'adaptateur SCSI 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'adaptateurs vhost disponibles. La sous-routine perfstat_virtualdiskadapter fournit les statistiques uniquement sur la machine VIOS.
Paramètres
| Article | Descriptif |
|---|---|
| nom | Contient les guillemets (""), FIRST_VHOST ou le nom indiquant le premier groupe de volumes d'adaptateur de réseau pour lequel les statistiques doivent être extraites. Par exemple: vhost0, vhost1. |
| buff utilisateur | Pointe vers la mémoire à remplir avec une ou plusieurs structures perfstat_diskadapter_t . |
| taille_struct | Indique la taille de la structure perfstat_diskadapter_t . |
| numéro_desired_ | Indique le nombre de structures perfstat_diskadapter_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.
Codes d'erreur
La sous-routine perfstat_virtualdiskadapter é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 | 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.