GETACINFO(3) Library Functions Manual GETACINFO(3)
getacinfo, getacdir, getacflg, getacmin, setac, endac - get audit con-
trol file information
int getacdir(dir, len)
int getacflg(auditstring, len)
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(5) The parameter len specifies the length of
the buffer dir . On return, dir points to the directory entry.
getacmin() 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 is invoked.
getacflg() reads the system audit value from the audit_control file and
returns the value in auditstring. The parameter len specifies the
length of the buffer auditstring.
Calling setac rewinds the audit_control file to allow repeated
Calling endac closes the audit_control file when processing is com-
getacdir(), getacflg() and getacmin() return:
0 on success.
-2 on failure and set errno to indicate the error.
getacmin() and getacflg() return:
1 on EOF.
-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
These functions return:
-3 if the directory entry format in the audit_control file is
getacdir() and getacflg() return:
-3 if the input buffer is too short to accommodate the record.
21 January 1990 GETACINFO(3)