NAME

xdas_initialize_session - initialize a session with the distributed audit service

SYNOPSIS

OM_uint32 xdas_initialize_session (
    	OM_uint32				*minor_status, 
    	const xdas_buffer_t			*security_context,
	const xdas_buffer_t			*org_info,
    	xdas_audit_ref_t			*das_ref
);

DESCRIPTION

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

The xdas_initialize_session() function initiates a session between the caller identified by org_info and the distributed audit service. The org_info is inserted by the implementation into every audit record submitted by the caller via subsequent calls to XDAS functions within the XDAS session. xdas_initialize_session() validates the security_context provided to ensure that caller has been authenticated and is authorized to use the XDAS.

If successful, the function returns das_ref, a handle to the XDAS server. The caller must have the XDAS_AUDIT_SERVICE authority.

If successful, the function returns [XDAS_S_COMPLETE].

The use of this function must itself be audited by the XDAS service.

The arguments for xdas_initialize_session() are:

minor_status (out)

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

security_context (optional,in)

An optional opaque structure defining the security context of the caller requesting use of the audit service. This is used to authenticate the caller to the XDAS and establish the callers XDAS authorizations. If this parameter is set to XDAS_NO_BUF, an XDAS implementation shall retrieve default security context from the process environment. The representation of a non-XDAS_NO_BUF security context is implementation defined.

org_info (in)

This buffer includes the originator information that is to be included with each audit event subsequently submitted by this caller. The XDAS service uses this information to populate the originator information of an audit record when xdas_start_record() is invoked.

das_ref (out)

The handle to the XDAS server is returned in das_ref.

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_INVALID_ORIG_INFO]

The originator information supplied has a syntax error.

[XDAS_S_INVALID_SECURITY_CONTEXT]

The security context supplied is not valid.

ERRORS

No other errors are defined.

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