Sous-routine pm_get_program_pthread

Editer en ligne

Objectif

Extrait les paramètres du moniteur de performances pour une unité d'exécution cible.

Bibliothèque

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

Syntaxe

#include <pmapi.h>  

int pm_set_program_pthread ( pid,  tid,  ptid,  *prog)
pid_t pid;
tid_t tid;
ptid_t ptid;
pm_prog_t *prog;

Descriptif

La sous-routine pm_get_program_pthread extrait les paramètres du moniteur de performances pour une pthread cible. Le pthread doit être arrêté et doit faire partie d'un processus de débogage, sous le contrôle du processus appelant. 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 doivent être sélectionnés dans les listes renvoyées par la sous-routine pm_inititialize .

Si pthread s'exécute en mode 1: 1, seul le paramètre tid doit être spécifié. Si pthread s'exécute en mode m: n, seul le paramètre ptid doit être spécifié. Si les paramètres ptid et tid sont tous deux spécifiés, ils doivent faire référence à un seul pthread avec le paramètre ptid spécifié et en cours d'exécution sur une unité d'exécution de noyau avec le paramètre tid spécifié.

Le mode de comptage inclut le mode utilisateur et le mode noyau, ainsi que l'état de comptage en cours.

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

Paramètres

Article Descriptif
PID ID de processus de pthread cible. Le processus cible doit être un argument d'un processus de débogage.
ID d'unité d'exécution ID unité d'exécution du pthread cible. Pour ignorer ce paramètre, définissez-le sur 0.
ptid ID pthread de la pthread cible. Pour ignorer ce paramètre, définissez-le sur 0.
* prog Renvoie les événements et les modes du moniteur de performances qui sont définis. Les modes suivants sont pris en charge:
UTILISATEUR_PM
Décompte les processus en cours d'exécution en mode utilisateur
NOYAU pm_kernel
Nombre de processus en cours d'exécution en mode noyau
NOM_COMPTE
Le comptage est activé

Valeurs renvoyées

Article Descriptif
0 Aucune erreur ne s'est produite.
Positive error code 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.