POSIX_TRACE_STOP(3) Library Functions Manual POSIX_TRACE_STOP(3)

posix_trace_start posix_trace_stop — trace start and stop (TRACING)


#include <trace.h>

int posix_trace_start(trace_id_t trid);
int posix_trace_stop (trace_id_t trid);

The posix_trace_start () and posix_trace_stop () functions, respectively, shall start and stop the trace stream identified by the argument .

The effect of calling the posix_trace_start () function shall be recorded in the trace stream as the POSIX_TRACE_START system trace event and the status of the trace stream shall become POSIX_TRACE_RUNNING. If the trace stream is in progress when this function is called, the POSIX_TRACE_START system trace event shall not be recorded and the trace stream shall continue to run. If the trace stream is full, the POSIX_TRACE_START system trace event shall not be recorded and the status of the trace stream shall not be changed.

The effect of calling the posix_trace_stop () function shall be recorded in the trace stream as the POSIX_TRACE_STOP system trace event and the status of the trace stream shall become POSIX_TRACE_SUSPENDED. If the trace stream is suspended when this function is called, the POSIX_TRACE_STOP system trace event shall not be recorded and the trace stream shall remain suspended. If the trace stream is full, the POSIX_TRACE_STOP system trace event shall not be recorded and the status of the trace stream shall not be changed.

Upon successful completion, these functions shall return a value of zero. Otherwise, they shall return the corresponding error number.

These functions shall fail if:

The value of the argument trid does not correspond to an active trace stream and thus no trace stream was started or stopped.
The operation was interrupted by a signal and thus the trace stream was not necessarily started or stopped.

None.

None.

None.

The posix_trace_start () and posix_trace_stop () functions may be removed in a future version.

posix_trace_create(3)

XBD <trace.h>

First released in Issue 6. Derived from IEEE Std 1003.1q-2000.

IEEE PASC Interpretation 1003.1 #123 is applied.

The posix_trace_start () and posix_trace_stop () functions are marked obsolescent.

January 1, 2008 posix.fail