Sous-routine perfstat_partial_reset

Editer en ligne

Objectif

Vide une partie du cache d'informations de configuration libperfstat ou réinitialise les compteurs minimum et maximum du système pour les disques.

Bibliothèque

bibliothèque perfstat (libperfstat.a)

Syntaxe

#include <libperfstat.h>

int perfstat_partial_reset (name, resetmask)
char * name;
u_longlong_t resetmask;

Descriptif

Les sous-routines perfstat_cpu_total, perfstat_disk, perfstat_diskadapter, perfstat_netinterfaceet perfstat_pagingspace renvoient des informations de configuration qui sont extraites de la base de données ODM et automatiquement mises en cache par la bibliothèque. D'autres métriques fournies par la bibliothèque LVM et la sous-routine swapqry sont également mises en cache à des fins de performances.

La sous-routine perfstat_partial_reset vide une partie de ce cache d'informations et doit être appelée chaque fois qu'une partie identifiée de la configuration de la machine a été modifiée.

La sous-routine perfstat_partial_reset peut être utilisée pour réinitialiser un composant particulier (tel que hdisk0 ou en1) lorsque le paramètre name n'est pas NULL et que le paramètre resetmask ne contient qu'un seul bit. Il peut également être utilisé pour supprimer une catégorie entière (comme les disques ou les chemins d'accès aux disques) des informations mises en cache.

Lorsque le paramètre name est NULL, le paramètre resetmask peut contenir une combinaison de bits, tels que FLUSH_DISK|RESET_DISK_MINMAX|FLUSH_CPUTOTAL.

Plusieurs masques de bits sont disponibles pour le paramètre resetmask . Le comportement de la fonction est le suivant:
Valeur resetmask Action lorsque nom est NULL Action lorsque nom n'est pas NULL et qu'un masque de réinitialisation unique est défini
TOTAL UC_FLUSH_UC Vidage vitesse et description dans la structure perfstat_cputotal_t Une erreur est renvoyée et errno est défini sur EINVAL.
DISQUE_FLUSH_DISQUE Vider description, adaptateur, taille, libreet Vgname dans chaque structure perfstat_disk_t . Videz la liste des adaptateurs de disque. Vider size, freeet description dans chaque structure perfstat_diskadapter_t . Vidage description, adaptateur, size, freeet vgname dans la structure perfstat_disk_t spécifiée. Videz adaptateur dans chaque perfstat_diskpath_t qui correspond au nom de disque suivi de _Path. Vidage size, freeet description de chaque perfstat_diskadapter_t lié à un chemin d'accès à ce disque ou au disque lui-même.
RESET_DISQUE_ALL Réinitialisez toutes les zones résidant sur le système dans chaque structure perfstat_disk_t . Une erreur est renvoyée et errno est défini sur EINVAL.
RESET_DISK_MINMAX Réinitialisez le système résident min_rserv, max_rserv, min_wserv, max_wserv, wq_min_time et wq_max_time dans chaque structure perfstat_disk_t . Une erreur est renvoyée et errno est défini sur ENOTSUP.
ADAPTATEUR_DISQUE_FLUSH_ Videz la liste des adaptateurs de disque. Vider size, freeet description dans chaque structure perfstat_diskadapter_t . Vider adaptateur dans chaque structure perfstat_diskpath_t . Vidage description et adaptateur dans chaque structure perfstat_disk_t . Videz la liste des adaptateurs de disque. Vider size, freeet description dans la structure perfstat_diskadapter_t spécifiée.
CHEMIN_DISQUE_FLUSH_ Vider adaptateur dans chaque structure perfstat_diskpath_t . Vider adaptateur dans la structure perfstat_diskpath_t spécifiée.
ESPACE_PAGING_FLUSH_ Vider la liste des espaces de pagination. Vider automatic, type, lpsize, mbsize, nom_hôte, nom_fichieret nom_fichier dans chaque structure perfstat_pagingspace_t . Vider la liste des espaces de pagination. Vider automatic, type, lpsize, mbsize, nom_hôte, nom_fichieret nom_fichier dans la structure perfstat_pagingspace_t spécifiée.
FLUSH_NETINTERFACE Vider description dans chaque structure perfstat_netinterface_t . Vider description dans la structure perfstat_netinterface_t spécifiée.

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

Article Descriptif
nom Contient un nom identifiant le composant dont les métriques doivent être réinitialisées à partir du cache libperfstat. Si ce paramètre est NULL, correspond à chaque composant.
masque de réinitialisation Catégorie du composant si le paramètre name n'est pas NULL. Les valeurs disponibles sont répertoriées dans le tableau précédent. Si le paramètre name est NULL, le paramètre resetmask peut être une combinaison de bits.

Valeurs renvoyées

La sous-routine perfstat_partial_reset renvoie la valeur 0 lorsque l'opération aboutit. En cas d'échec, la valeur -1 est renvoyée et la variable globale errno est définie sur le code approprié.

Codes d'erreur

Article Descriptif
EINVAL L'un des paramètres n'est pas valide.

Fichiers

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