Sous-routine perfstat_virtualdisktarget

Editer en ligne

Objectif

Extrait les statistiques d'utilisation de l'unité cible virtuelle (VTD) sur le serveur Virtual I/O Server (VIOS).

Bibliothèque

Bibliothèque Perfstat (libperfstat.a)

Syntaxe

#include <libperfstat.h>
int perfstat_virtualdisktarget (name, userbuff, sizeof_struct, desired_number)
perfstat_id_t * name;
perfstat_disk_t * userbuff;
size_t sizeof_struct;int desired_number;

Descriptif

La sous-routine perfstat_virtualdisktarget extrait une ou plusieurs statistiques d'utilisation d'unité cible virtuelle.

La même fonction peut également être utilisée pour extraire le nombre d'ensembles disponibles de statistiques d'utilisation de l'unité cible virtuelle.

Pour obtenir un ou plusieurs ensembles de métriques d'utilisation d'unité cible virtuelle, définissez le paramètre name sur le nom de la première unité cible virtuelle pour laquelle les statistiques doivent être collectées et définissez le paramètre desired_number . Pour démarrer à partir de la première unité cible virtuelle, définissez le paramètre name entre guillemets ("") ou FIRST_VTD. Le paramètre userbuff doit toujours pointer vers la zone de mémoire suffisamment grande pour contenir le nombre de structures perfstat_disk_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 ou sur les guillemets ("") après la copie de toutes les structures.

Pour extraire le nombre d'ensembles disponibles de métriques d'utilisation d'unité cible virtuelle, 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. La sous-routine perfstat_virtualdisktarget fournit les statistiques uniquement sur la machine VIOS.

Les zones de structure perfstat_disk_t suivantes ne sont pas renseignées par la sous-routine perfstat_virtualdisktarget :
  • description
  • VGname
  • Taille
  • libérer
  • qdepth
  • adaptateur
  • nombre_chemins
  • id_wpar

Paramètres

Article Descriptif
nom Contient les guillemets (""), FIRST_VTD, ou le nom indiquant le premier adaptateur de réseau pour lequel les statistiques doivent être extraites. Par exemple: vtscsi0, vtscsi1.
buff utilisateur Pointe vers la mémoire à remplir avec une ou plusieurs structures perfstat_disk_t .
taille_struct Indique la taille de la structure perfstat_disk_t .
numéro_desired_ Indique le nombre de structures perfstat_disk_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_virtualdisktarget é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.