posix_trace_rewind Subroutine
Purpose
Re-initializes the trace log for reading.
Library
Posix Trace Library (libposixtrace.a)
Syntax
#include <trace.h>
int posix_trace_rewind (trid)
trace_id_t trid;Description
The posix_trace_rewind subroutine resets the current trace event time stamp to the time stamp of the oldest trace event recorded in the trace log identified by the trid parameter. The current trace event time stamp specifies the time stamp of the trace event that will be read by the next call to posix_trace_getnext_event subroutine.
Parameters
| Item | Description |
|---|---|
| trid | Specifies the trace stream identifier. |
Return Values
On successful completion, the subroutine returns a value of zero. Otherwise, it returns the corresponding error number.
Errors
The posix_trace_rewind subroutine
fails if the following error returns:
| Item | Description |
|---|---|
| EINVAL | The object pointed to by the trid parameter does not correspond to a valid trace log. |
Files
The trace.h file in the Files Reference.