xdas_initialise_session(3xdas)


xdas_initialise_session -- initialize a session with the distributed audit service

Synopsis

cc [flag ...] file ... -Kthread -leels [library] ...
#include <sys/xdas.h>

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

Description

The xdas_initialise_session(3xdas) function is a member of the Basic XDAS Conformance class.

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

If successful, the function returns das_ref, a handle to the XDAS server. This handle may be used by both the XDAS functions and by the generic logging functions described in the Section 3eels manual pages in Section 3eels manual pages.

The caller must possess the XDAS_AUDIT_SERVICE authority.

On success, xdas_initialise_session(3xdas) returns XDAS_S_COMPLETE.

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

Arguments


minor_status
(Output) Provides additional information when the function returns XDAS_S_FAILURE.

security_context
(Optional input) 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 XDAS and to establish the caller's XDAS authorizations. If this parameter is set to XDAS_NO_BUF, XDAS retrieves default security context from the process environment.

org_info
(Input) 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(3xdas) is invoked.

das_ref
(Output) A handle to the XDAS server.

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_ORIG_INFO
The originator information supplied has a syntax error.

XDAS_S_INVALID_SECURITY_CONTEXT
The security context supplied is invalid.

References

xdas_initialise_session(D3xdas), xdas_commit_record(3xdas), xdas_discard_record(3xdas), xdas_put_event_info(3xdas), xdas_start_record(3xdas), xdas_terminate_session(3xdas), xdas_timestamp_record(3xdas)


© 2004 The SCO Group, Inc. All rights reserved.
UnixWare 7 Release 7.1.4 - 25 April 2004