xdas_commit_record(XDAS)

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

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

The caller must possess the XDAS_AUDIT_SUBMIT authority.

On success, xdas_commit_record(XDAS) returns XDAS_S_COMPLETE.

If any of the event_number, outcome, initiator_info, target_info and event_info parameters to xdas_start_record(XDAS) and xdas_put_event_info(XDAS) 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(XDAS) 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