sous-routine pm_get_data_mygroup, pm_get_tdata_mygroup ou pm_get_Tdata_mygroup
Objectif
Renvoie les données du moniteur de performances pour le groupe de comptage auquel appartient l'unité d'exécution appelante.
Bibliothèque
Bibliothèque d'API Performance Monitor (libpmapi.a)
Syntaxe
#include <pmapi.h>
int pm_get_data_mygroup (*pmdata)
pm_data_t *pmdata;
int pm_get_tdata_mygroup (*pmdata, *time)
pm_data_t *pmdata;
timebasestruct_t *time;
int pm_get_Tdata_mygroup (pmdata, * times)
pm_data_t *pmdata;
pm_accu_time_t *times;Descriptif
La sous-routine pm_get_data_mygroup extrait les données du moniteur de performances en cours pour le groupe auquel appartient l'unité d'exécution du noyau appelant.
La sous-routine pm_get_tdata_mygroup extrait les données du moniteur de performances en cours pour le groupe auquel appartient l'unité d'exécution appelante, ainsi qu'un horodatage indiquant la dernière lecture des compteurs matériels.
La sous-routine pm_get_Tdata_mygroup extrait les données du moniteur de performances en cours pour le groupe auquel appartient l'unité d'exécution appelante, ainsi que le temps cumulé (base de temps, temps PURR et temps SPURR) pendant lequel les événements ont été comptabilisés.
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. Les informations renvoyées incluent également les caractéristiques du groupe, telles que le nombre de ses membres, s'il s'agit d'un groupe de niveau processus, et si ses compteurs sont cohérents avec la somme des compteurs de toutes les unités d'exécution du groupe.
Paramètres
| Article | Descriptif |
|---|---|
| * pmdata | Pointeur vers une structure pour renvoyer les données du moniteur de performances pour le groupe auquel appartient l'unité d'exécution appelante. |
| * 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. |