NAME

getauditflagsbin, getauditflagschar − convert audit flag specifications

SYNOPSIS

#include <sys/label.h>
#include <sys/audit.h>
#include <sys/auevents.h>

int getauditflagsbin(auditstring, masks)
char ∗auditstring;
audit_state_t ∗masks;

int getauditflagschar(auditstring, masks, verbose)
char ∗auditstring;
audit_state_t ∗masks;
int verbose;

DESCRIPTION

getauditflagsbin() converts the character representation of audit values pointed to by auditstring into audit_state_t fields pointed to by masks. These fields indicate which events are to be audited when they succeed and which are to be audited when they fail. The character string syntax is described in audit_control(5). 

getauditflagschar() converts the audit_state_t fields pointed to by masks into a string pointed to by auditstring. If verbose is zero, the short (2-character) flag names are used.  If verbose is non-zero, the long flag names are used.  auditstring should be large enough to contain the ASCII representation of the events. 

auditstring contains a series of event names, each one identifying a single audit class, separated by commas.  The audit_state_t fields pointed to by masks correspond to binary values defined in audit.h.

DIAGNOSTICS

−1 is returned on error and 0 on success. 

SEE ALSO

audit.log(5), audit_control(5)

BUGS

This is not a very extensible interface. 

Sun Release 4.0  —  Last change: 6 October 1987