Sous-routine pm_get_program
Objectif
Extrait les paramètres du moniteur de performances à l'échelle du système.
Bibliothèque
Bibliothèque d'API Performance Monitor (libpmapi.a)
Syntaxe
Descriptif
La sous-routine pm_get_program extrait 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 une liste d'identificateurs d'événement. Les identificateurs proviennent des listes renvoyées par la sous-routine pm_init .
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 activé, le comptage s'applique uniquement au processus appelant et à ses personnes à charge.
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 du tableau d'événements contient l'ID de groupe. Les autres éléments du tableau d'événements ne sont pas significatifs.
Paramètres
| Article | Descriptif |
|---|---|
| prog | Renvoie les événements et les modes du moniteur de performances qui sont définis. Les modes pris en charge sont les suivants:
|
Valeurs renvoyées
| Article | Descriptif |
|---|---|
| 0 % | Aucune erreur ne s'est produite. |
| 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. |