xdas_import_event_records(3xdas)


xdas_import_event_records -- import records from an external audit service into XDAS in XDAS common format

Synopsis

cc [flag ...] file ... -Kthread -leels [library] ...
#include <sys/xdas.h>

OM_uint32 xdas_import_event_records( OM_uint32 *minor_status, const xdas_audit_ref_t *das_ref, const xdas_buffer_t *audit_record_buffer, OM_uint32 *position_in_buffer);

Description

The xdas_import_event_records(3xdas) function is a member of the XDAS Import API Option Conformance class.

xdas_import_event_records(3xdas) allows a caller to import audit event records in the XDAS format directly to the XDAS service. The caller places one or more complete audit event records into the buffer referred to by audit_record_buffer from which they are copied and integrated into the XDAS audit stream. The function reads audit records until the start of a next record is not found. The implementation may select the records that are actually imported based upon some selection criteria. The caller is not advised of the disposition of the audit records it submits.

The caller must possess the XDAS_AUDIT_IMPORT authority.

If successful, the function returns XDAS_S_COMPLETE.

Arguments


minor_status
(Output) Provides further information when the function returns XDAS_S_FAILURE.

das_ref
(Input) A handle to the XDAS service obtained by a previous call to xdas_initialise_session(3xdas).

audit_record_buffer
(Input) A buffer into which the caller places the audit records to be imported into the XDAS audit stream.

position_in_buffer
(Output) If a record syntax error is detected, this parameter contains the position in the buffer at which the error was detected.

Return values


XDAS_S_AUTHORISATION_FAILURE
The caller does not possess the required authority.

XDAS_S_COMPLETE
Successful completion.

XDAS_S_FAILURE
An implementation-specific error or failure has occurred, such as missing required parameters, or a malloc failure.

XDAS_S_INVALID_DAS_REF
The audit service handle supplied does not point to the audit service.

XDAS_S_RECORD_SYNTAX_ERROR
A syntax error has been detected in an input record.

References

xdas_initialise_session(3xdas)
© 2004 The SCO Group, Inc. All rights reserved.
UnixWare 7 Release 7.1.4 - 25 April 2004