NAME

dce_aud_print —  Formats an audit record into human-readable form.  Used by audit trail examination and analysis tools. 

Synopsis

void dce_aud_print(
dce_aud_rec_t ard,
unsigned32 options,
char ∗∗buffer,
unsigned32 ∗status);

Parameters

Input

ardAn audit record descriptor.  This descriptor can be obtained from an opened audit trail by calling dce_aud_next() or it can be a new record established by calling one of the dce_aud_start_∗() functions. 

optionsThe options governing the transformation of the binary audit record information into a character string.  The value of the options parameter is the bitwise OR of any selected combination of the following option values:

aud_c_evt_all_info
Includes all the optional information (that is, groups, address, and event specific information).

aud_c_evt_groups_info
Includes the groups’ information.

aud_c_evt_address_info
Includes the address information.

aud_c_evt_specific_info
Includes the event specific information.

Output

bufferReturns the pointer to a character string converted from the audit record specified by ard. 

statusThe status code returned by this routine.  This status code indicates whether the routine was completed successfully or not.  If the routine was not completed successfully, the reason for the failure is given. 

Description

The dce_aud_print() function transforms the audit record specified by ard into a character string and places it in a buffer.  The buffer is allocated using  malloc(), and must later be freed by the caller.  (This function allocates the memory to hold the human-readable text of the audit record and returns the address of this memory in the buffer parameter.) 

The options parameter is set to the bitwise OR of flag values defined in the dce/audit.h header file.  A value of 0 (zero) for options will result in default operation, that is, no group, address, and event-specific information is included in the output string. 

Return Values

No value is returned. 

Errors

The following describes a partial list of errors that might be returned.  Refer to the OSF DCE Problem Determination Guide for complete descriptions of all error messages. 

aud_s_invalid_record_descriptor
The audit record descriptor is invalid.

aud_s_cannot_allocate_memory
The malloc() call failed. 

aud_s_ok
The call was successful.

Status codes passed from sec_login_get_current_context()

Status codes passed from sec_login_inquire_net_info()

Related Information

Functions: dce_aud_next(3sec), dce_aud_open(3sec), dce_aud_put_ev_info(3sec), dce_aud_start(3sec), dce_aud_start_with_name(3sec), dce_aud_start_with_pac(3sec), dce_aud_start_with_server_binding(3sec).