xdas_commit_record(D3xdas)
xdas_commit_record --
write completed audit record to audit stream
Synopsis
#include <sys/xdas.h>
OM_uint32 xdas_commit_record(
OM_uint32 *minor_status,
const xdas_audit_ref_t *das_ref,
const xdas_audit_rec_desc_t *audit_record_descriptor);
Description
The
xdas_commit_record(D3xdas)
function is a member of the Basic
XDAS Conformance class.
xdas_commit_record(D3xdas)
writes the audit record identified by audit_record_descriptor
to the current audit stream controlled by the audit services and accessed
by das_ref. XDAS adds the time information to the
audit record unless a previous call to
xdas_timestamp_record
has been made using audit_record_descriptor.
The caller must possess the XDAS_AUDIT_SUBMIT authority.
On success,
xdas_commit_record(D3xdas)
returns
XDAS_S_COMPLETE.
If any of the event_number, outcome,
initiator_info, target_info and
event_info parameters to
xdas_start_record
and
xdas_put_event_info
have not been completed in at least one such call (even when component
fields are empty), this call returns XDAS_S_INCOMPLETE_RECORD.
Arguments
minor_status-
(Output)
Provides further information when the function returns
XDAS_S_FAILURE.
das_ref-
(Input)
A handle to the audit service obtained from a previous call to
xdas_initialise_session.
audit_record_descriptor-
(Input)
A descriptor referring to a completed audit record to be written to
the audit stream. On successful completion,
audit_record_descriptor is no longer a valid reference to
an audit record.
NOTE:
The storage associated with audit_record_descriptor is
reclaimed when it is closed.
Return values
XDAS_S_COMPLETE-
Successful completion.
XDAS_S_FAILURE-
An implementation-specific error or failure has occurred, such as
missing required parameters, or a kernel allocated memory failure.
XDAS_S_INCOMPLETE_RECORD-
The audit record has not been fully populated by the caller.
XDAS_S_INVALID_DAS_REF-
The handle to the audit service is invalid.
XDAS_S_INVALID_RECORD_DESCRIPTOR-
The specified audit record descriptor is invalid.
XDAS_S_SERVICE_FAILURE-
There has been an audit service failure.
XDAS_S_STORAGE_FAILURE-
The audit record cannot be written to stable storage.
References
xdas_commit_record,
xdas_initialise_session(D3xdas),
xdas_put_event_info(D3xdas),
xdas_start_record(D3xdas),
xdas_timestamp_record(D3xdas)
© 2005 The SCO Group, Inc. All rights reserved.
OpenServer 6 and UnixWare (SVR5) HDK - 19 June 2005