Sous-routine trcstop

Objectif

Arrtrace une session de trace.

Bibliothèque

Bibliothèque des services d'exécution (librts.a)

Syntaxe

# inclure < sys/trcmacros.h >
# définir TRCSTOP SERIAL 0x40000000
# définir TRCSTOP DISCARDBUFS 0x20000000
int trcstop( Channel)
int Channel;

Descriptif

La sous-routine Trcstop arrête une session de trace pour un canal de trace particulier.

Paramètres

Article Descriptif
Canal Indique l'un des huit canaux de trace. Le numéro de canal 0 fait toujours référence à la trace Event / Performance. Les numéros de canal 1 à 7 indiquent les canaux de trace génériques.
Série (TRCSTOP SERIAL) Si le canal est ORed avec l'indicateur Série , la sous-routine Trcstop sérialise les opérations d'E-S de trace à partir de plusieurs mémoires tampon de processeur dans le fichier de trace. L'indicateur Série est applicable pour tous les modes de traçage. Cet indicateur s'exclut mutuellement avec l'indicateur Discard_buff .
Discard_buff (TRCSTOP DISCARDBUFF0) Pour définir cette option, l'utilisateur doit utiliser l' Discard_buff OR avec l'option de canal. Lorsqu'elle est appelée, la sous-routine Trcstop rejette toutes les mémoires tampon de trace capturées en attente d'opération d'entrée-sortie. Si des mémoires tampon de trace ont déjà été écrites dans un fichier, l'indicateur Discard_buff est ignoré. Cet indicateur s'exclut mutuellement avec le drapeau série.

Valeurs renvoyées

Article Descriptif
0 % La session de trace a été arrêtée.
-1 La session de trace n'a pas été arrêtée.