Sous-routine pm_start_thread et pm_tstart_thread

Editer en ligne

Objectif

Démarre le comptage 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_start_thread (pid, tid)
pid_t pid;
tid_t tid;

int pm_tstart_thread ( pid,  tid, *time)
pid_t pid;
tid_t tid;
timebasestruct_t *time

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_start_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_start_pthread avec un paramètre ptid égal à 0.

La sous-routine pm_start_thread démarre le comptage 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 comptage est effectif immédiatement sauf si l'unité d'exécution se trouve dans un groupe et que le comptage de groupe n'est pas actuellement défini sur On. L'état de comptage d'une unité d'exécution dans un groupe est obtenu en utilisant une combinaison de l'état de comptage de l'unité d'exécution avec l'état de groupe.

La sous-routine pm_tstart_thread démarre le comptage du moniteur de performances pour une unité d'exécution du noyau cible et renvoie un horodatage indiquant à quel moment le comptage a été lancé.

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.
* heure Pointeur vers une structure contenant la valeur de base de temps lors du démarrage du comptage. Il peut être converti en temps à l'aide de la sous-routine time_base_to_time .

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.