Previous section.

Distributed Audit Service (XDAS)
Copyright © 1998 The Open Group


xdas_commit_record - write a completed audit record to the audit stream


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



xdas_commit_record() is a member of the Basic XDAS Conformance class.

The xdas_commit_record() function writes the audit record identified by audit_record_descriptor to the current audit stream controlled by the audit service and accessed by das_ref. The XDAS implementation 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 have the XDAS_AUDIT_SUBMIT authority.

If successful, the function returns [XDAS_S_COMPLETE].

If any of the event_number, outcome, initiator_information, target_information 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, then this call shall return [XDAS_S_INCOMPLETE_RECORD].

The arguments for xdas_commit_record() are:

minor_status (out)

An implementation specific return status that provides additional information when [XDAS_S_FAILURE] is returned by the function.

das_ref (in)

Handle to the audit service obtained from a previous call to xdas_initialize_session().

audit_record_descriptor (in)

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.
An implementation may reclaim any storage associated with an audit_record_descriptor when that audit_record_descriptor is closed.


The following XDAS status codes shall be returned:


The caller does not possess the required authority


Successful completion.


An implementation specific error or failure has occurred.


The audit record has not been fully populated by the caller.


The handle to the audit service is not valid.


The specified audit record descriptor is not valid.


The called function is not supported by this implementation.


There has been an audit service failure.


The audit record cannot be written to stable storage.


No other errors are defined.

[??] Some characters or strings that appear in the printed document are not easily representable using HTML.

Why not acquire a nicely bound hard copy?
Click here to return to the publication details or order a copy of this publication.

Contents Next section Index