Sous-routine pm_set_program_wp_mm

Editer en ligne

Objectif

Définit la programmation du moniteur de performances en mode de multiplexage de compteurs pour une partition de charge de travailspécifiée.

Syntaxe

#include <pmapi.h>

int pm_set_program_wp_mm (cid, *prog_mm)
cid_t cid; 
pm_prog_mm_t *prog_mm;

Descriptif

La sous-routine pm_set_program_wp_mm définit la programmation du moniteur de performances en mode de multiplexage de compteurs pour les processus appartenant à une partition de charge de travail (WPAR) spécifiée. La programmation inclut la liste des tableaux d'événements à compter, ainsi que le mode associé pour compter chaque tableau d'événements. Un mode de comptage est défini pour chaque tableau d'événements. Les identificateurs doivent être sélectionnés dans les listes renvoyées par la sous-routine pm_initialize Subroutine . Si la liste inclut un événement pouvant être utilisé avec un seuil, vous pouvez spécifier une valeur de seuil.

Sur certaines plateformes, vous pouvez spécifier un groupe d'événements à la place d'événements individuels. Définissez la zone de bit is_group dans le mode et entrez l'ID de groupe dans le premier élément de chaque tableau d'événements. L'ID groupe peut être obtenu par la sous-routine pm_initialize .

Le mode de comptage inclut à la fois le mode utilisateur et le mode noyau, ou l'un d'entre eux, l'état de comptage initial et le mode d'arborescence de processus. Les valeurs par défaut pour le mode utilisateur et le mode noyau sont Off. L'état par défaut initial est défini pour retarder le comptage jusqu'à l'appel de la sous-routine pm_start (pm_start et pm_tstart Subroutine) et pour compter les activités de tous les processus s'exécutant dans la WPARspécifiée.

Si vous utilisez la sous-routine pm_set_program_wp_mm pour un comptage multimode, le mode d'arborescence de processus (PM_PROCTREE) et le mode de démarrage du comptage (PM_COUNT) conservent les valeurs définies dans le premier ensemble de programmation.

Si le mode d'arborescence de processus est défini sur l'état On , le comptage s'applique uniquement au processus appelant et à ses descendants.

Paramètres

Article Descriptif
cid Indique l'identificateur de la WPAR pour laquelle la programmation doit être définie. Le CID peut être obtenu à partir du nom de la WPAR à l'aide de l'appel système getcorralid .
prog_mm Indique les événements et les modes associés à utiliser dans la configuration du moniteur de performances. Les modes suivants sont pris en charge:
UTILISATEUR_PM
Compte les processus qui s'exécutent en mode utilisateur. La valeur par défaut est Off.
NOYAU pm_kernel
Compte les processus qui s'exécutent en mode noyau. La valeur par défaut est Off.
NOM_COMPTE
Commence à compter immédiatement. La valeur par défaut est Not to start counting.
PM_PROCTREE
Définit le comptage sur On uniquement pour le processus appelant et ses descendants. La valeur par défaut est Off.

Valeurs renvoyées

Article Descriptif
0 % L'opération a abouti.
Code d'erreur positif Exécutez la sous-routine pm_error (pm_error Subroutine) pour décoder le code d'erreur.

Codes d'erreur

Pour décoder le code d'erreur, voir la sous-routine pm_error (pm_error Subroutine).

Fichiers

Article Descriptif
/usr/include/pmapi.h Définit des macros standard, des types de données et des sous-routines.