Sous-routine pm_set_program_wp

Objectif

Définit la programmation du moniteur de performances pour une partition de charge de travail (WPAR) spécifiée.

Syntaxe

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

Descriptif

La sous-routine pm_set_program_wp définit la programmation du moniteur de performances pour les processus appartenant à la partition de charge de travail (WPAR) spécifiée. La programmation comprend les événements à compter, ainsi qu'un mode de comptage.

Les événements à compter 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_initialize . 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 du 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. 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. 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 et pour compter les activités de tous les processus s'exécutant sur la WPARspécifiée.

Paramètres

Article Descriptif

cid Indique l'identificateur de la WPAR pour laquelle la sous-routine doit être définie. Le CID peut être obtenu à partir du nom de la WPAR à l'aide de l'appel système getcorralid .

Article	Descriptif
cid	Indique l'identificateur de la WPAR pour laquelle la sous-routine doit être définie. Le CID peut être obtenu à partir du nom de la WPAR à l'aide de l'appel système getcorralid .
prog	Indique les événements et les modes à 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`.

prog

Indique les événements et les modes à 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 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.