POSIX_TRACE_START(3) Library Functions Manual POSIX_TRACE_START(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.

None.

posix_trace_create(3), the Base Definitions volume of IEEE Std 1003.1-2001 (“POSIX.1”), <trace.h>

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

IEEE PASC Interpretation 1003.1 #123 is applied.

footer end

January 1, 2004 posix.fail