posix_trace_start, Subroutine

Online bearbeiten

Zweck

Startet einen Trace.

Bibliothek

Posix-trace-bibliothek (libposixtrace.a)

Syntax

#include <trace.h>

int posix_trace_start(trid)
trace_id_t trid;

Beschreibung

Die Subroutine posix_trace_start startet den durch den Parameter trid angegebenen Tracedatenstrom.

Die Auswirkung des Aufrufs der Subroutine posix_trace_start wird im Tracedatenstrom als Systemtraceereignis POSIX_TRACE_START aufgezeichnet und der Status des Tracedatenstroms wird in POSIX_TRACE_RUNNINGgeändert. Wenn der Tracedatenstrom in Bearbeitung ist, wenn diese Subroutine aufgerufen wird, wird das Systemtraceereignis POSIX_TRACE_START nicht aufgezeichnet und der Tracedatenstrom wird weiter ausgeführt. Wenn der Tracedatenstrom voll ist, wird das Systemtraceereignis POSIX_TRACE_START nicht aufgezeichnet und der Status des Tracedatenstroms wird nicht geändert.

Parameter

Element Beschreibung
Trid Gibt die ID des Tracedatenstroms an

Rückgabewerte

Nach erfolgreichem Abschluss gibt diese Subroutine den Wert null zurück. Andernfalls wird die entsprechende Fehlernummer zurückgegeben.

Fehler

Die Subroutine schlägt fehl, wenn die folgende Fehlernummer zurückgegeben wird:
Element Beschreibung
EINVAL Der Wert des Parameters trid entspricht keinem aktiven Tracedatenstrom und daher wird kein Tracedatenstrom gestartet oder gestoppt.

Dateien

Die Datei trace.h in Files Reference.