PreviousNext

dce_aud_rewind(3sec)

Rewinds the specified audit trail. Used by the trail analysis and examination tools.

Synopsis

#include <dce/audit.h>

void dce_aud_rewind(
dce_aud_trail_t
at
unsigned32 *
status);

Parameters

Input

at
A pointer to the descriptor of an audit trail file previously opened for reading by the function dce_aud_open( ).

Output

status
The status code returned by this function. This status code indicates whether the routine was completed successfully or not. If the routine was not completed successfully, the reason for the failure is given.

Description

The dce_aud_rewind( ) function rewinds the audit trail file. This function can be used to instantly clean up the audit trail file if it is no longer needed. dce_aud_open( ) must be called to specify the desired audit trail file, and the specified audit trail file must be opened with the aud_c_trl_open_write flag. Otherwise, the routine will rewind the audit trail which is currently set in the value of at.

If the call is successful, the file cursors are set to the beginning of the file..

Return Values

No value is returned.

Errors

The following describes a partial list of errors that might be returned. Refer to the OSF DCE Problem Determination Guide for complete descriptions of all error messages.

aud_s_ok
The call was successful.

aud_s_invalid_trail_descriptor
The audit trail descriptor is invalid.

aud_s_trl_invalid_open_flag
The audit trail is opened with open flag.

aud_s_rewind_trl_flag
The fruncate( ) call failed on trail file.

aud_s_rewind_index_flag
The fruncate( ) call failed on index file.

Related Information

Function: dce_aud_open(3sec)