pm_get_data_pthread, pm_get_tdata_pthread ou pm_get_Tdata_pthread Sous-routine
Objectif
Renvoie les données du moniteur de performances pour un pthread cible.
Bibliothèque
Bibliothèque d'API Performance Monitor (libpmapi.a)
Syntaxe
#include <pmapi.h>
int pm_get_data_pthread (pid, tid, ptid, *pmdata)
pid_t pid;
tid_t tid;
ptid_t ptid;
pm_data_t *pmdata;
int pm_get_tdata_pthread (pid, tid, ptid, *pmdata, *time)
pid_t pid;
tid_t tid;
ptid_t ptid;
pm_data_t *pmdata;
timebasestruct_t *time;
int pm_get_Tdata_pthread (pid, tid, ptid,*pmdata, * times)
pid_t pid;
tid_t tid;
ptid_t ptid;
pm_data_t *pmdata;
pm_accu_time_t *times;Descriptif
La sous-routine pm_get_data_pthread extrait les données du moniteur de performances en cours pour une pthread cible. Le pthread doit être arrêté et doit faire partie d'un processus de débogage sous le contrôle d'un processus appelant.
La sous-routine pm_get_tdata_pthread extrait les données du moniteur de performances en cours pour une unité d'exécution cible, ainsi qu'un horodatage indiquant l'heure de la dernière lecture des compteurs matériels.
La sous-routine pm_get_Tdata_pthread extrait les données du moniteur de performances en cours pour une unité d'exécution cible et le temps cumulé (base de temps, temps PURR et temps SPURR) pendant lequel les événements ont été comptabilisés.
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é.
Les données de l'Analyseur de performances sont toujours un ensemble (un par compteur matériel sur la machine utilisée) de valeurs de 64 bits.
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. |
| * pmdata | Pointeur vers une structure pour renvoyer les données du moniteur de performances pour le pthread cible. |
| * heure | Pointeur vers une structure contenant la valeur de base de temps lors de la dernière lecture des compteurs de surveillance des performances du matériel. Il peut être converti en temps à l'aide de la sous-routine time_base_to_time . |
| * fois | Pointeur vers une structure contenant le temps cumulé (base de temps, temps PURR et temps SPURR) que les événements ont été comptés. Chaque compteur de temps peut être converti en temps à l'aide de la sous-routine time_base_to_time . |
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. |