Sous-routine pm_set_program

Objectif

Définit la programmation du moniteur de performances à l'échelle du système.

Bibliothèque

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

Syntaxe

#include <pmapi.h>

int pm_set_program ( *prog)
pm_prog_t *prog; 

Descriptif

La sous-routine pm_set_program définit la programmation du moniteur de performances à l'échelle du système. Le paramètre inclut les événements à compter et 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 les listes renvoyées par la sous-routine pm_init .

Le mode de comptage inclut le mode de noyau and/or du mode utilisateur, l'état de comptage initial et le mode d'arborescence de processus. Le mode d'arborescence de processus définit le comptage sur On uniquement pour le processus appelant et ses descendants. Les valeurs par défaut sont définies sur Off pour le mode utilisateur et le mode noyau. L'état par défaut initial est défini pour retarder le comptage jusqu'à ce que la sous-routine pm_start soit appelée et pour compter l'activité de tous les processus en cours d'exécution dans le système.

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.

Sur certaines plateformes, des groupes d'événements peuvent être spécifiés à la place d'événements individuels. Pour ce faire, définissez le champ de bits is_group dans le mode et placez l'ID de groupe dans le premier élément du tableau d'événements. (L'ID groupe a été obtenu par pm_init).

Paramètres

Valeurs renvoyées

Codes d'erreur

Reportez-vous à la sous-routine pm_error.

Fichiers