xdas_commit_record(3xdas)


xdas_commit_record -- write completed audit record to audit stream

Synopsis

cc [flag ...] file ... -Kthread -leels [library] ...
#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(3xdas) function is a member of the Basic XDAS Conformance class.

xdas_commit_record(3xdas) 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(3xdas) has been made using audit_record_descriptor.

The caller must possess the XDAS_AUDIT_SUBMIT authority.

On success, xdas_commit_record(3xdas) returns XDAS_S_COMPLETE.

If any of the event_number, outcome, initiator_info, target_info and event_info parameters to xdas_start_record(3xdas) and xdas_put_event_info(3xdas) 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(3xdas) or eels_initialise(3eels).

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_AUTHORISATION_FAILURE
The caller does not possess the correct 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_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(D3xdas), xdas_initialise_session(3xdas), xdas_put_event_info(3xdas), xdas_start_record(3xdas), xdas_timestamp_record(3xdas)


© 2004 The SCO Group, Inc. All rights reserved.
UnixWare 7 Release 7.1.4 - 25 April 2004