Sous-routine pm_set_program_thread

Editer en ligne

Objectif

Définit la programmation 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_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_set_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 équivaut à un appel à la sous-routine pm_set_program_pthread avec un paramètre ptid égal à 0.

La sous-routine pm_set_program_thread définit la programmation 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. 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 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 le délai de comptage jusqu'à l'appel de la sous-routine pm_start_thread .

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
PID ID processus de l'unité d'exécution cible. Le processus cible doit être un débogueur du processus appelant.
ID d'unité d'exécution ID de l'unité d'exécution cible.
* prog Indique les modes d'événement à utiliser dans la configuration du moniteur de performances. Les modes suivants sont pris en charge:
UTILISATEUR_PM
Décompte les processus en cours d'exécution en mode utilisateur (la valeur par défaut est Off)
NOYAU pm_kernel
Nombre de processus en cours d'exécution en mode noyau (la valeur par défaut est Off)
NOM_COMPTE
Démarre le comptage immédiatement (la valeur par défaut est Not to Start Counting)

Valeurs renvoyées

Article Descriptif
0 L'opération a abouti.
Code d'erreur positif Reportez-vous à la sous-routine pm_error (pm_error Subroutine) pour décoder le code d'erreur.

Codes d'erreur

Reportez-vous à la sous-routine pm_error (pm_error Subroutine).

Fichiers

Article Descriptif
/usr/include/pmapi.h Définit des macros standard, des types de données et des sous-routines.