Previous section.

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

NAME

xdas_commit_record - write a completed audit record to the audit stream

SYNOPSIS

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

RETURN VALUE

The following XDAS status codes shall be returned:

[XDAS_S_AUTHORIZATION_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.

[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 not valid.

[XDAS_S_INVALID_RECORD_DESCRIPTOR]

The specified audit record descriptor is not valid.

[XDAS_S_NOT_SUPPORTED]

The called function is not supported by this implementation.

[XDAS_S_SERVICE_FAILURE]

There has been an audit service failure.

[DAS_S_STORAGE_FAILURE]

The audit record cannot be written to stable storage.

ERRORS

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