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