Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

OpenSolaris 2009.06 - man page for getacflg (opensolaris section 3bsm)

getacinfo(3BSM) 				      Security and Auditing Library Functions					   getacinfo(3BSM)

NAME
getacinfo, getacdir, getacflg, getacmin, getacna, setac, endac - get audit control file information
SYNOPSIS
cc [ flag... ] file... -lbsm -lsocket -lnsl [ library... ] #include <bsm/libbsm.h> int getacdir( char *dir, int len); int getacmin( int *min_val); int getacflg( char *auditstring, int len); int getacna( char *auditstring, int len); void setac(void); void endac(void);
DESCRIPTION
When first called, getacdir() provides information about the first audit directory in the audit_control file. Thereafter, it returns the next directory in the file. Successive calls list all the directories listed in audit_control(4) The len argument specifies the length of the buffer dir. On return, dir points to the directory entry. The getacmin() function reads the minimum value from the audit_control file and returns the value in min_val. The minimum value specifies how full the file system to which the audit files are being written can get before the script audit_warn(1M) is invoked. The getacflg() function reads the system audit value from the audit_control file and returns the value in auditstring. The len argument specifies the length of the buffer auditstring. The getacna() function reads the system audit value for non-attributable audit events from the audit_control file and returns the value in auditstring. The len argument specifies the length of the buffer auditstring. Non-attributable events are events that cannot be attributed to an individual user. The inetd(1M) utility and several other daemons record non-attributable events. The setac() function rewinds the audit_control file to allow repeated searches. The endac() function closes the audit_control file when processing is complete.
FILES
/etc/security/audit_control file containing default parameters read by the audit daemon, auditd(1M)
RETURN VALUES
The getacdir(), getacflg(), getacna(), and getacmin() functions return: 0 on success. -2 on failure and set errno to indicate the error. The getacmin() and getacflg() functions return: 1 on EOF. The getacdir() function returns: -1 on EOF. 2 if the directory search had to start from the beginning because one of the other functions was called between calls to getacdir(). These functions return: -3 if the directory entry format in the audit_control file is incorrect. The getacdir(), getacflg(), and getacna() functions return: -3 if the input buffer is too short to accommodate the record.
ATTRIBUTES
See attributes(5) for descriptions of the following attributes: +-----------------------------+-----------------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +-----------------------------+-----------------------------+ |MT-Level |Safe | +-----------------------------+-----------------------------+
SEE ALSO
audit_warn(1M), bsmconv(1M), inetd(1M), audit_control(4), attributes(5)
NOTES
The functionality described on this manual page is available only if the Solaris Auditing has been enabled. See bsmconv(1M) for more information. SunOS 5.11 31 Mar 2005 getacinfo(3BSM)