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 AIX® Version 7.1 Files Reference.