Sous-routines pm_get_program_mx et pm_get_program_mm

Editer en ligne

Objectif

Extrait les paramètres du moniteur de performances à l'échelle du système en mode de multiplexage de compteur et en mode multimode.

Bibliothèque

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

Syntaxe

#include <pmapi.h>

int pm_get_program_mx ( *prog)
pm_prog_mx_t *prog;

int pm_get_program_mm (*prog_mm)
pm_prog_mm_t *prog_mm;

Descriptif

Les sous-routines pm_get_program_mx et pm_get_program_mm extraient les paramètres actuels du moniteur de performances à l'échelle du système. Cela inclut les informations de mode et les événements en cours de comptage, qui se trouvent dans un tableau de liste d'identificateurs d'événement. Les identificateurs proviennent des listes renvoyées par la sous-routine pm_initialize . Lorsque vous utilisez la sous-routine pm_get_program_mm pour le comptage multimode, un mode est associé à chaque liste d'événements.

Le mode de comptage comprend le mode utilisateur, le mode noyau, 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 s'applique uniquement au processus appelant et à ses descendants.

Si la liste inclut un événement qui peut être utilisé avec un seuil (comme indiqué par la sous-routine pm_init ), une valeur de seuil est également renvoyée.

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 le tableau alloué pour stocker les listes d'événements (zone events_set dans le prog).

Paramètres

Article Descriptif
prog Renvoie les événements et les modes du moniteur de performances qui sont définis. Il prend en charge les modes suivants:
UTILISATEUR_PMR
Comptage des processus en cours d'exécution en mode utilisateur.
PM_KERNEL
Comptage des processus en cours d'exécution en mode noyau.
NOM_PMT
Le comptage est en place.
PM_PROCTREE
Le comptage s'applique uniquement au processus appelant et à ses descendants.
prog_mm Renvoie les événements du moniteur de performances et les modes associés définis. Il prend en charge les modes suivants:
UTILISATEUR_PM
Comptage des processus en cours d'exécution en mode utilisateur.
NOYAU pm_kernel
Comptage des processus en cours d'exécution en mode noyau.
NOM_COMPTE
Le comptage est activé.
PM_PROCTREE
Le comptage s'applique uniquement au processus appelant et à ses descendants.

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

Valeurs renvoyées

Article Descriptif
0 % Aucune erreur ne s'est produite.
Code d'erreur positif Reportez-vous à la sous-routine pm_error (pm_error Subroutine) pour décoder le code d'erreur.

Codes d'erreur

Reportez-vous à 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.