au_preselect(3)

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUES | SUMMARY OF TRUSTED SOLARIS CHANGES | FILES | ATTRIBUTES | SEE ALSO | NOTES

NAME

au_preselect- Preselect an audit event

SYNOPSIS

cc [flags...] file ... -lbsm -lsocket -lnsl -lintl [library...]


#include <bsm/libbsm.h>

int au_preselect(au_event_t event, au_mask_t *mask_p, int sorf, int flag);

DESCRIPTION

au_preselect() determines whether or not the audit event event is preselected against the binary preselection mask pointed to by mask_p (usually obtained by a call to getaudit(2)). au_preselect() looks up the classes associated with event in audit_event(4) and compares them with the classes in mask_p. If the classes associated with event match the classes in the specified portions of the binary preselection mask pointed to by mask_p, the event is said to be preselected.

sorf indicates whether the comparison is made with the success portion, the failure portion or both portions of the mask pointed to by mask_p.

The following are the valid values of sorf:

AU_PRS_SUCCESS

Compare the event class with the success portion of the preselection mask.

AU_PRS_FAILURE

Compare the event class with the failure portion of the preselection mask.

AU_PRS_BOTH

Compare the event class with both the success and failure portions of the preselection mask.

flag tells au_preselect() how to read the audit_event(4) database. Upon initial invocation, au_preselect() reads the audit_event(4) database and allocates space in an internal cache for each entry with malloc(3C). In subsequent invocations, the value of flag determines where au_preselect() obtains audit event information. The following are the valid values of flag:

AU_PRS_REREAD

Get audit event information by searching the audit_event(4) database.

AU_PRS_USECACHE

Get audit event information from internal cache created upon the initial invocation. This option is much faster.

RETURN VALUES

au_preselect() returns:

0

event is not preselected.

1

event is preselected.

-1

An error occurred. au_preselect() couldn't allocate memory or couldn't find event in the audit_event(4) database.

SUMMARY OF TRUSTED SOLARIS CHANGES

This function looks up the classes associated with event in audit_event(4) rather than in audit_event(4). By default, auditing is enabled in the Trusted Solaris environment.

FILES

/etc/security/audit_class

Maps audit class number to audit class names and descriptions.

/etc/security/audit_event

Maps audit event number to audit event names.

ATTRIBUTES

See attributes(5) for a description of the following attributes:

ATTRIBUTE TYPE	ATTRIBUTE VALUE
MT-Level	MT-Safe

SEE ALSO

Trusted Solaris 7 Reference Manual

getaudit(2), auditwrite(3), getauclassent(3), getauevent(3), audit_class(4), audit_event(4)

SunOS 5.7 Reference Manual

malloc(3C), attributes(5)

NOTES

This functionality is active only if the auditing has been enabled. By default, auditing is enabled in the Trusted Solaris environment. See Trusted Solaris Audit Administration for how to disable and enable auditing. au_preselect() is normally called prior to constructing and writing an audit record. If the event is not preselected, the overhead of constructing and writing the record can be saved.

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUES | SUMMARY OF TRUSTED SOLARIS CHANGES | FILES | ATTRIBUTES | SEE ALSO | NOTES