xdas_open_audit_stream(XDAS)

xdas_open_audit_stream -- open the audit stream

Synopsis

cc [flag ...] file ... -Kthread -leels [library] ...

#include <sys/xdas.h>

OM_uint32 xdas_open_audit_stream(
	OM_uint32 *minor_status,
	const xdas_audit_ref_t *das_ref,
	xdas_audit_stream_t **audit_stream_ref);

Description

The xdas_open_audit_stream(XDAS) function is a member of the Basic XDAS Conformance class.

xdas_open_audit_stream(XDAS) opens the audit stream for reading and returns a handle to the audit stream in audit_stream_ref. A caller may obtain more than one handle to the audit stream. Each handle is independent of any other handles.

The caller must possess the XDAS_AUDIT_READ authority.

On success, xdas_open_audit_stream(XDAS) returns XDAS_S_COMPLETE.

Arguments

minor_status: (Output) Provides additional information when the function returns XDAS_S_FAILURE.
das_ref: (Input) A handle to the XDAS server, obtained from a previous call to xdas_initialise_session(XDAS).
audit_strem_ref: (Input) The handle to the audit stream returned by xdas_open_audit_stream.

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_INVALID_DAS_REF: The handle to the audit service is invalid.

References

xdas_close_audit_stream(XDAS), xdas_initialise_session(XDAS), xdas_rewind_audit_stream(XDAS)