Sous-routine pm_set_program_mygroup
Objectif
Définit la programmation du moniteur de performances pour l'unité d'exécution appelante et crée un groupe de comptage.
Bibliothèque
Bibliothèque d'API Performance Monitor (libpmapi.a)
Syntaxe
#include <pmapi.h>
int pm_set_program_mygroup ( *prog)
pm_prog_t *prog; Descriptif
La sous-routine pm_set_program_mygroup définit la programmation du moniteur de performances pour l'unité d'exécution du noyau appelant. 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 .
Cet appel crée également un groupe de comptage, qui inclut l'unité d'exécution appelante et toute unité d'exécution qu'elle ou l'un de ses descendants créera dans le futur. Eventuellement, le groupe peut être défini comme contenant également toutes les unités d'exécution existantes et futures appartenant au processus appelant.
Le mode de comptage inclut le mode utilisateur et / ou le mode noyau, ainsi que 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 delay comptage jusqu'à l'appel de la sous-routine pm_start_mygroup .
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. Les modes suivants sont pris en charge:
|
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. |