Sous-routine pm_get_program_wp_mm

Objectif

Renvoie les paramètres du moniteur de performances en mode de multiplexage de compteurs pour une partition de charge de travailspécifiée.

Bibliothèque

Bibliothèque d'API Performance Monitor (libpmapi.a)

Syntaxe

#include <pmapi.h>

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

Descriptif

La sous-routine pm_get_program_wp_mm extrait les paramètres actuels du moniteur de performances en mode de multiplexage de compteurs pour une partition de charge de travail (WPAR) spécifiée. Les paramètres incluent les informations de mode et les événements en cours de comptage, qui se trouvent dans un tableau d'une liste d'identificateurs d'événement. 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, une valeur de seuil est également renvoyée.

Lorsque vous utilisez la sous-routine pm_get_program_wp_mm pour le comptage multimode, un mode est associé à chaque liste d'événements.

Le mode de comptage inclut à la fois le mode utilisateur et le mode noyau, ou l'un d'entre eux, l'état de comptage en cours et le mode d'arborescence de processus. Si le mode d'arborescence de processus est défini, le comptage est appliqué uniquement au processus appelant et à ses descendants.

Si les événements sont représentés par un ID de groupe, le bit is_group est défini dans le mode et le premier élément de chaque tableau d'événements contient l'ID de groupe. Les autres éléments du tableau d'événements ne sont pas utilisés.

L'application utilisateur doit libérer la grappe allouée pour stocker les listes d'événements.

Paramètres

Article	Descriptif
cid	Indique l'identificateur de la WPAR pour laquelle la programmation doit être extraite. Le CID peut être obtenu à partir du nom de la WPAR à l'aide de l'appel système getcorralid .
prog_mm	Renvoie les événements et les modes du moniteur de performances définis. Les modes suivants sont pris en charge: UTILISATEUR_PM Comptage des processus qui s'exécutent en mode utilisateur. NOYAU pm_kernel Comptage des processus qui s'exécutent en mode noyau. NOM_COMPTE Le comptage est en cours. PM_PROCTREE Comptage uniquement des activités du processus appelant et de ses descendants. Le mode PM_PROCTREE et le mode PM_COUNT sont communs à tous les modes définis.

Article

Descriptif

cid

Indique l'identificateur de la WPAR pour laquelle la programmation doit être extraite. Le CID peut être obtenu à partir du nom de la WPAR à l'aide de l'appel système getcorralid .

prog_mm

Renvoie les événements et les modes du moniteur de performances définis. Les modes suivants sont pris en charge:

UTILISATEUR_PM: Comptage des processus qui s'exécutent en mode utilisateur.
NOYAU pm_kernel: Comptage des processus qui s'exécutent en mode noyau.
NOM_COMPTE: Le comptage est en cours.
PM_PROCTREE: Comptage uniquement des activités du processus appelant et de ses descendants.

Le mode PM_PROCTREE et le mode PM_COUNT sont communs à tous les modes définis.

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.