Sous-routine pm_get_program_thread

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_get_program_thread ( pid, tid, *prog) pid_t pid; tid_t tid; pm_prog_t *prog;

Descriptif

Cette sous-routine ne prend en charge que le modèle d'unités d'exécution 1: 1. Il a été remplacé par la sous-routine pm_get_program_pthread , qui prend en charge les modèles d'unités d'exécution 1: 1 et M: N. Un appel à cette sous-routine est équivalent à un appel à la sous-routine pm_get_program_pthread avec un paramètre ptid égal à 0.

La sous-routine pm_get_program_thread extrait les paramètres du moniteur de performances pour une unité d'exécution du noyau cible. L'unité d'exécution doit être arrêtée et 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 proviennent des listes renvoyées par la sous-routine pm_init .

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_init ), une valeur de seuil est également renvoyée.

Paramètres

Article	Descriptif
PID	Identificateur de processus de l'unité d'exécution cible. Le processus cible doit être un argument d'un processus de débogage.
ID d'unité d'exécution	Identificateur de l'unité d'exécution cible.
* prog	Renvoie les événements et les modes du moniteur de performances qui sont définis. Les modes pris en charge sont les suivants: UTILISATEUR_PMR Comptage des processus en cours d'exécution en mode Utilisateur PM_KERNEL Comptage des processus en cours d'exécution en mode Noyau NOM_PMT Le comptage est activé

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.