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