The Open Group Base Specifications Issue 7
IEEE Std 1003.1, 2013 Edition
Copyright © 2001-2013 The IEEE and The Open Group

NAME

posix_trace_start, posix_trace_stop - trace start and stop (TRACING)

SYNOPSIS

[OB TRC] [Option Start] #include <trace.h>

int posix_trace_start(trace_id_t
trid);
int posix_trace_stop (trace_id_t
trid); [Option End]

DESCRIPTION

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

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.

RETURN VALUE

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

ERRORS

These functions shall fail if:

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

The following sections are informative.

EXAMPLES

None.

APPLICATION USAGE

None.

RATIONALE

None.

FUTURE DIRECTIONS

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

SEE ALSO

posix_trace_create

XBD <trace.h>

CHANGE HISTORY

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

IEEE PASC Interpretation 1003.1 #123 is applied.

Issue 7

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

End of informative text.

 

return to top of page

UNIX ® is a registered Trademark of The Open Group.
POSIX ® is a registered Trademark of The IEEE.
Copyright © 2001-2013 The IEEE and The Open Group, All Rights Reserved
[ Main Index | XBD | XSH | XCU | XRAT ]