dce_aud_reset(3sec)
Resets the cursors and the file pointers of the specified audit trail. Used by the trail analysis and examination tools.
Synopsis
#include <dce/audit.h>
void dce_aud_reset(
dce_aud_trail_t at
unsigned32 *status);
Parameters
Input
at
A pointer to the descriptor of an audit trail file previously opened 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. For a list of the possible status codes and their meanings, see "Errors."
Description
The dce_aud_reset( ) function resets the cursors and the file pointers of the specified audit trail file. The function is used to explicitly reset the current cursors and file pointers to the beginning of the audit trail files.
dce_aud_open( ) must be called to specify the desired audit trail file. Otherwise, dce_aud_reset( ) will reset 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. The possible status codes and their meaning are:
aud_s_ok
The call was successful.
aud_s_invalid_trail_descriptor
The audit trail descriptor is invalid.
Related Information
Functions: dce_aud_rewind(3sec)