Sous-routine pm_get_program_wp

Objectif

Extrait les paramètres du moniteur de performances à l'échelle du système pour une partition de charge de travail spécifiée (WPAR).

Bibliothèque

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

Syntaxe

#include <pmapi.h> 
int pm_get_program_wp (cid, *prog)
cid_t cid;
pm_prog_t *prog;

Descriptif

La sous-routine pm_get_program_wp extrait les paramètres du moniteur de performances à l'échelle du système pour les processus appartenant à la partition de charge de travailspécifiée. Ces paramètres incluent les informations de mode et les événements qui sont comptés.

Les événements en cours de comptage figurent dans une liste d'identificateurs d'événement. Les identificateurs doivent être sélectionnés dans la liste renvoyée par la sous-routine pm_init . Si la liste inclut un événement pouvant être utilisé avec un seuil, vous pouvez spécifier une valeur de seuil.

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 du tableau d'événements contient l'ID de groupe. Les autres éléments du tableau d'événements ne sont pas significatifs.

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.

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 sous-routine doit être extraite. Le CID peut être obtenu à partir du nom de la WPAR à l'aide de l'appel système getcorralid .
prog	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 du processus appelant et de ses descendants.

Valeurs renvoyées

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

Codes d'erreur

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

Fichiers

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