pm_get_data_mygroup_mx ou pm_get_tdata_mygroup_mx Sous-routine

Editer en ligne

Objectif

Renvoie les données du moniteur de performances en mode de multiplexage de compteurs 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_mx (*pmdata)
pm_data_mx_t *pmdata;

int pm_get_tdata_mygroup_mx (*pmdata, *time)
pm_data_mx_t *pmdata;
timebasestruct_t *time;

Descriptif

La sous-routine pm_get_data_mygroup_mx extrait les données du moniteur de performances en cours en mode de multiplexage de compteurs pour le groupe auquel appartient l'unité d'exécution du noyau appelant.

La sous-routine pm_get_tdata_mygroup_mx extrait les données du moniteur de performances en cours en mode de multiplexage de compteurs pour le groupe auquel appartient l'unité d'exécution appelante, ainsi qu'un horodatage indiquant l'heure de la dernière lecture des compteurs matériels.

Les données du moniteur de performances sont toujours un ensemble de valeurs de 64 bits (une par compteur de matériel sur la machine utilisée). 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.

L'application utilisateur doit libérer le tableau alloué pour stocker les comptages cumulés et les temps (zone accu_set de pmdata).

Paramètres

Article Descriptif
* pmdata Pointeur vers une structure pour renvoyer les données du moniteur de performances (tableau des compteurs cumulés, du temps cumulé et du temps PURR et SPURR cumulé pour chaque ensemble d'événements compté) 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 .

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.