Sous-routine pm_reset_data_pgroup

Editer en ligne

Objectif

Réinitialise les données du moniteur de performances pour une unité d'exécution de programme cible et le groupe de comptage auquel elle appartient.

Bibliothèque

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

Syntaxe

#include <pmapi.h>

int pm_reset_data_pgroup ( pid,  tid,  ptid)  
pid_t pid;  
tid_t tid;
ptid_t ptid;

Descriptif

La sous-routine pm_reset_data_pgroup réinitialise les données du moniteur de performances en cours pour une unité d'exécution de programme cible et le groupe de comptage auquel elle appartient. Le pthread doit être arrêté et doit faire partie d'un processus de débutée, sous le contrôle du processus appelant. Les données sont un ensemble (un par compteur matériel sur la machine utilisée) de valeurs de 64 bits. Toutes les valeurs sont réinitialisées à 0. Etant donné que les données de toutes les autres unités d'exécution du groupe ne sont pas affectées, le groupe est marqué comme incohérent à moins qu'il ne comporte qu'un seul membre.

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é.

Paramètres

Article Descriptif
PID ID de processus de pthread cible. Le processus cible doit être un débogueur du processus appelant.
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.

Valeurs renvoyées

Article Descriptif
0 L'opération a abouti.
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.