Sous-routine pm_start_group et pm_tstart_group

Editer en ligne

Objectif

Démarre le comptage du moniteur de performances pour le groupe de comptage auquel appartient une unité d'exécution cible.

Bibliothèque

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

Syntaxe

#include <pmapi.h>

int pm_start_group ( pid,  tid)
pid_t pid;
tid_t tid;

int pm_tstart_group ( 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_pgroup , qui prend en charge les modèles d'unités d'exécution 1: 1 et M: N. Un appel à cette sous-routine est équivalent à un appel à la sous-routine pm_start_pgroup avec un paramètre ptid égal à 0.

La sous-routine pm_start_group démarre le comptage du moniteur de performances pour une unité d'exécution du noyau cible et le groupe de comptage auquel elle appartient. Ce comptage est effectif immédiatement pour l'unité d'exécution cible. Pour tous les autres membres d'unité d'exécution du groupe de comptage, le comptage démarre après leur prochaine nouvelle répartition, mais uniquement si leur état de comptage en cours est déjà 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. Si leur état de comptage est actuellement défini sur Off, aucun comptage ne démarre jusqu'à ce qu'ils appellent la sous-routine pm_start_mythread ou la sous-routine pm_start_mygroup eux-mêmes, ou jusqu'à ce qu'un processus de débogage appelle la sous-routine pm_start_thread ou la sous-routine pm_start_group pour leur compte.

La sous-routine pm_tstart_group démarre le comptage du moniteur de performances pour une unité d'exécution du noyau cible et le groupe de comptage auquel elle appartient, et renvoie un horodatage indiquant quand le comptage a été démarré.

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