unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (SunOS-4.1.3)
Page:
Section:
Apropos / Subsearch:
optional field

GETACINFO(3)               Library Functions Manual               GETACINFO(3)



NAME
       getacinfo,  getacdir, getacflg, getacmin, setac, endac - get audit con-
       trol file information

SYNOPSIS
       int getacdir(dir, len)
       char *dir;
       int len;

       int getacmin(min_val)
       int *min_val;

       int getacflg(auditstring, len)
       char *auditstring;
       int len;

       void setac()

       void endac()

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(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
       searches.

       Calling endac closes the audit_control file  when  processing  is  com-
       plete.

RETURN VALUES
       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.

       getacdir() 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.

       getacdir() and getacflg() return:

       -3     if the input buffer is too short to accommodate the record.

SEE ALSO
       audit_control(5)



                                21 January 1990                   GETACINFO(3)