xdas_parse_record(3xdas)


xdas_parse_record -- parse an audit event record in an audit record buffer

Synopsis

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

OM_uint32 xdas_parse_record( OM_uint32 *minor_status, const xdas_audit_ref_t *das_ref, const xdas_audit_desc_t *audit_record_buffer, const OM_uint32 record_number, xdas_audit_record_t *audit_record);

Description

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

xdas_parse_record(3xdas) parses and decomposes a record number identified by record_number found in the audit record buffer, audit_record_buffer, which has been filled by a previous call to xdas_get_next(3xdas).

If record_number does not match a record within audit_record_buffer, xdas_parse_record(3xdas) returns XDAS_S_INVALID_RECORD_NUMBER.

On success, xdas_parse_record(3xdas) 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(3xdas).

audit_record_buffer
(Input) The handle to the audit record buffer, filled by a previous call to xdas_get_next(3xdas).

record_number
(Input) The number of the record to be retrieved from audit_record_buffer. The first record is referred to by a record_number of 0.

audit_record
(Input and output) The structure containing the fields of the parsed audit record.

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 does not point to the audit daemon.

XDAS_S_INVALID_EVENT_NO
The specified event number is invalid.

XDAS_S_INVALID_INITIATOR_INFO
The initiator information supplied has a syntax error.

XDAS_S_INVALID_OUTCOME
The specified outcome is invalid.

XDAS_S_INVALID_RECORD_NUMBER
The specified audit record number id invalid

XDAS_S_INVALID_TARGET_INFO
The specified target information has a syntax error.

XDAS_S_NO_AUDIT
The event specified does not need to be audited.

XDAS_S_NO_DECISION_YET
The audit service has insufficient information to decide if the event requires auditing.

XDAS_S_INVALID_EVENT_INFO
The specified audit event information is not valid.

References

xdas_get_next(3xdas), xdas_initialise_session(3xdas)
© 2004 The SCO Group, Inc. All rights reserved.
UnixWare 7 Release 7.1.4 - 25 April 2004