Security and Auditing Library Functions       getauditflags(3BSM)



NAME
     getauditflags, getauditflagsbin, getauditflagschar - convert
     audit flag specifications

SYNOPSIS
     cc [ flag... ] file... -lbsm  -lsocket    -lnsl   [ library... ]
     #include 
     #include 

     int getauditflagsbin(char *auditstring, aumaskt *masks);


     int getauditflagschar(char *auditstring, aumaskt *masks, int verbose);


DESCRIPTION
     The  getauditflagsbin()  function  converts  the   character
     representation  of  audit  values  pointed to by auditstring
     into aumaskt fields pointed  to  by  masks.  These  fields
     indicate  which  events  are to be audited when they succeed
     and which are to be audited when they  fail.  The  character
     string syntax is described in auditcontrol(4).


     The  getauditflagschar()  function  converts  the  aumaskt
     fields  pointed  to  by  masks  into  a string pointed to by
     auditstring. If verbose is 0, the short  (2-character)  flag
     names  are used. If verbose is non-zero, the long flag names
     are used. The auditstring argument should be large enough to
     contain the ASCI representation of the events.


     The auditstring argument contains a series of  event  names,
     each one identifying a single audit class, separated by com-
     mas.  The aumaskt fields pointed to by masks correspond to
     binary  values  defined  in  , which is read by
     .

RETURN VALUES
     Upon successful completion, getauditflagsbin() and getaudit-
     flagschar() return 0. Otherwise they return -1.

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










SunOS 5.11          Last change: 31 Mar 2005                    1






Security and Auditing Library Functions       getauditflags(3BSM)



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     MT-Level                     MT-Safe                     
    


SEE ALSO
     bsmconv(1M), audit.log(4), auditcontrol(4), attributes(5)

BUGS
     This is not a very extensible interface.

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                    2