Sous-routine posix_trace_flush

Objectif

Lance un vidage sur le flux de trace.

Bibliothèque

Bibliothèque de trace Posix (libposixtrace.a)

Syntaxe

#include <sys/types.h>
#include <trace.h>

int posix_trace_flush (trid)
trace_id_t trid;

Descriptif

La sous-routine posix_trace_flush lance une opération de vidage qui copie le contenu du flux de trace identifié par le paramètre trid dans le journal de trace associé au flux de trace au moment de la création. Si aucun journal de trace n'a été associé au flux de trace désigné par le paramètre trid , cette sous-routine renvoie une erreur. L'arrêt de l'opération de vidage peut être interrogé par la sous-routine posix_trace_get_status . Une fois le vidage terminé, l'espace utilisé par les événements de trace vidés est disponible pour le traçage des nouveaux événements de trace. Lors de l'opération de vidage, il est possible de tracer de nouveaux événements de trace jusqu'à ce que le flux de trace soit saturé.

Si le vidage du flux de trace rend le journal de trace saturé, la règle de saturation du journal de trace est appliquée. Si l'attribut trace log-full-policy est défini, les événements suivants se produisent:

POSIX_TRACE_UNTIL_FULL: Les événements de trace qui n'ont pas été vidés sont supprimés.
POSIX_TRACE_LOOP: Les événements de trace qui n'ont pas été vidés sont écrits au début du journal de trace, en écrasant les événements de trace précédents qui y ont été stockés.
NOM_APP_TRACE_POSIEND: Les événements de trace qui n'ont pas été vidés sont ajoutés au journal de trace.

Pour un flux de trace actif avec le journal, lorsque la sous-routine posix_trace_shutdown est appelée, tous les événements de trace qui n'ont pas été vidés dans le journal de trace sont vidés et le journal de trace est fermé.

Lorsqu'un journal de trace est fermé, toutes les informations qui peuvent être extraites ultérieurement du journal de trace via l'interface de trace sont écrites dans le journal de trace. Ces informations incluent les attributs de trace, la liste des types d'événement de trace (avec le mappage entre les noms d'événement de trace et les identificateurs de type d'événement de trace) et le statut de la trace.

La sous-routine posix_trace_shutdown n'est pas renvoyée tant que tous les événements de trace n'ont pas été vidés.

Paramètres

Tableau 1. Paramètres
Article	Descriptif
`TRID`	Indique l'identificateur du flux de trace.

Valeurs renvoyées

Une fois l'opération terminée, ces sous-programmes renvoient la valeur zéro. Sinon, ils renvoient le numéro d'erreur correspondant.

Erreurs

Tableau 2. Erreurs
Article	Descriptif
`EINVAL`	La valeur du paramètre `trid` ne correspond pas à un flux de trace actif avec un journal.
`ENOSPC`	Il ne reste plus d'espace sur l'unité.

Fichiers

Les fichiers trace.h et types.h dans Files Reference.