xdas_import_event_records(XDAS)

Synopsis

#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

xdas_import_event_records(XDAS) 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(XDAS).

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