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 

     int getacdir( char *dir, int len);


     int getacmin( int *minval);


     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 auditcontrol file. Thereafter,
     it returns the next directory in the file. Successive  calls
     list  all the directories listed in auditcontrol(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
     auditcontrol  file  and  returns  the value in minval. The
     minimum value specifies how full the file  system  to  which
     the  audit files are being written can get before the script
     auditwarn(1M) is invoked.


     The getacflg() function reads the system  audit  value  from
     the auditcontrol file and returns the value in auditstring.
     The len argument specifies the length of the  buffer  audit-
     string.


     The getacna() function reads  the  system  audit  value  for
     non-attributable  audit  events  from the auditcontrol file
     and returns the  value  in  auditstring.  The  len  argument
     specifies   the  length  of  the  buffer  auditstring.  Non-



SunOS 5.11          Last change: 31 Mar 2005                    1






Security and Auditing Library Functions           getacinfo(3BSM)



     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 auditcontrol file to allow
     repeated searches.


     The endac() function closes the auditcontrol file when pro-
     cessing is complete.

FILES
     /etc/security/auditcontrol

         file containing default parameters  read  by  the  audit
         daemon, auditd(1M)


RETURN VALUES
     The getacdir(), getacflg(), getacna(), and getacmin()  func-
     tions 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  auditcontrol
              file is incorrect.




SunOS 5.11          Last change: 31 Mar 2005                    2






Security and Auditing Library Functions           getacinfo(3BSM)



     The getacdir(), getacflg(), and getacna() functions return:

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


ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     MT-Level                     Safe                        
    


SEE ALSO
     auditwarn(1M),  bsmconv(1M),  inetd(1M),  auditcontrol(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          Last change: 31 Mar 2005                    3