pm_set_program_mythread_mx et pm_set_program_mythread_mm Sous-routines

Editer en ligne

Objectif

Définit la programmation du moniteur de performances en mode de multiplexage de compteur et en mode multiple pour l'unité d'exécution appelante.

Bibliothèque

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

Syntaxe

#include <pmapi.h>

int pm_set_program_mythread_mx ( *prog)
pm_prog_mx_t *prog;

int pm_set_program_mythread_mm ( *prog_mm)
pm_prog_mm_t *prog_mm;

Descriptif

Les sous-routines pm_set_program_mythread_mx et pm_set_program_mythread_mm définissent la programmation du moniteur de performances respectivement en mode de multiplexage de compteur ou en mode multimode pour l'unité d'exécution du noyau appelant.

Le paramètre de sous-routine pm_set_program_mythread_mx inclut la liste des tableaux d'événements à compter et un mode de comptage. Le mode est global pour toutes les listes d'événements. Les événements à compter se trouvent dans une liste d'identificateurs d'événement.

Le paramètre pm_set_program_mythread_mm inclut les listes des tableaux d'événements à compter et les modes associés dans lesquels compter chaque tableau d'événements. Un mode de comptage est défini pour chaque tableau d'événements.

Les identificateurs d'événement doivent être sélectionnés dans les listes renvoyées par la sous-routine pm_initialize .

Le mode de comptage pour les deux sous-routines inclut le mode utilisateur ou le mode noyau, ou les deux ; et l'état de comptage initial. Les valeurs par défaut sont définies sur Off pour le mode utilisateur et le mode noyau, et l'état par défaut initial est défini sur différé jusqu'à l'appel de la sous-routine pm_start_mythread .

Lorsque vous utilisez la sous-routine pm_set_program_mythread_mm pour le comptage multimode, le mode d'arborescence de processus et le mode de démarrage du comptage sont fixés par les valeurs définies dans le premier ensemble de programmation.

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 peut également être spécifiée.

Paramètres

Article Descriptif
* prog Indique les événements et les modes à utiliser dans la configuration du moniteur de performances. Le paramètre prog prend en charge les modes suivants:
UTILISATEUR_PM
Compte les processus en cours d'exécution en mode utilisateur (la valeur par défaut est Off).
NOYAU pm_kernel
Compte les processus en cours d'exécution en mode noyau (la valeur par défaut est Off).
NOM_COMPTE
Démarre le comptage immédiatement (la valeur par défaut est Not to Start Counting).
PROCESSUS PM_DE
Crée un groupe de comptage au niveau du processus.
* prog_mm Indique les événements et les modes à utiliser dans la configuration du moniteur de performances. Le paramètre prog_mm prend en charge les modes suivants:
UTILISATEUR_PM
Compte les processus en cours d'exécution en mode utilisateur (la valeur par défaut est Off).
NOYAU pm_kernel
Compte les processus en cours d'exécution en mode noyau (la valeur par défaut est Off).
NOM_COMPTE
Démarre le comptage immédiatement (la valeur par défaut est définie sur Non pour démarrer le comptage).
PM_PROCTREE
Définit le comptage sur On uniquement pour le processus appelant et ses descendants (la valeur par défaut est Off).

Le mode PM_PROCTREE et le mode PM_COUNT définis dans le premier paramètre corrigent la valeur du comptage.

Valeurs renvoyées

Article Descriptif
0 L'opération a abouti.
Code d'erreur positif Reportez-vous à la sous-routine pm_error 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.