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] #include <trace.h>
> int posix_trace_start(trace_id_t` trid`);
> int posix_trace_stop (trace_id_t` trid`);``
> `
> `

#### 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 ]