Sous-routine perfstat_protocol

Objectif

Extrait les statistiques d'utilisation du protocole.

Bibliothèque

Bibliothèque Perfstat (libperfstat.a)

Syntaxe

#include <libperfstat.h>


int perfstat_protocol (name, userbuff, sizeof_struct, desired_number)
perfstat_id_t *name;
perfstat_protocol_t *userbuff;
size_t sizeof_struct;
int desired_number;

Descriptif

La sous-routine perfstat_protocol extrait des statistiques d'utilisation de protocole telles que ICMP, ICMPv6, IP, IPv6, TCP, UDP, RPC, NFS, NFSv2, NFSv3. Pour obtenir un ou plusieurs ensembles de métriques d'utilisation de protocole, définissez le paramètre name sur le nom du premier protocole pour lequel les statistiques sont souhaitées et définissez le paramètre desired_number .

Pour démarrer à partir du premier protocole, définissez le paramètre name sur "" ou FIRST_PROTOCOL. Le paramètre userbuff doit pointer vers une zone de mémoire suffisamment grande pour contenir le nombre souhaité de structures perfstat_protocol_t qui seront copiées par cette fonction. A son retour, le paramètre name sera défini sur le nom du protocole suivant ou sur "" si toutes les structures ont été copiées.

Pour extraire le nombre d'ensembles de métriques d'utilisation de protocole disponibles, définissez les paramètres name et userbuff sur NULL et le paramètre desired_number sur 0. La valeur renvoyée sera le nombre d'ensembles disponibles.

Cette sous-routine n'est pas prise en charge dans une partition de charge de travail (WPAR). Il n'a pas connaissance d'une WPAR.

Paramètres

Valeurs renvoyées

Une fois l'opération terminée, le nombre de structures pouvant être remplies est renvoyé. En cas d'échec, la valeur -1 est renvoyée et la variable globale errno est définie.

Codes d'erreur

Fichiers

Le fichier libperfstat.h définit les macros standard, les types de données et les sous-routines.