Security and Auditing Library Functions       getauclassent(3BSM)



NAME
     getauclassent,   getauclassnam,   setauclass,    endauclass,
     getauclassnamr, getauclassentr - get auditclass entry

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

     struct auclassent *getauclassnam( const char *name);


     struct auclassent *getauclassnamr( auclassentt *classint,
          const char *name);


     struct auclassent *getauclassent(void);


     struct auclassent *getauclassentr( auclassentt *classint);


     void setauclass(void);


     void endauclass(void);


DESCRIPTION
     The getauclassent() function and getauclassnam() each return
     an auditclass entry.


     The getauclassnam() function  searches  for  an  auditclass
     entry with a given class name name.


     The getauclassent() function enumerates auditclass entries.
     Successive calls to getauclassent() return either successive
     auditclass entries or NUL.


     The setauclass() function ``rewinds'' to  the  beginning  of
     the  enumeration  of  auditclass  entries.  Calls to getau-
     classnam() may leave the  enumeration  in  an  indeterminate
     state,  so  setauclass()  should  be called before the first
     getauclassent().


     The endauclass() may be called to indicate that  auditclass
     processing  is  complete; the system may then close any open
     auditclass file, deallocate storage, and so forth.



SunOS 5.11          Last change: 31 Mar 2005                    1






Security and Auditing Library Functions       getauclassent(3BSM)



     The getauclassentr() and getauclassnamr()  functions  both
     return  a  pointer to an auditclass entry as do their simi-
     larly named counterparts.   They  each  take  an  additional
     argument,   a   pointer   to   pre-allocated  space  for  an
     auclassentt, which is returned if the call is successful.
     To   assure  there  is  enough  space  for  the  information
     returned, the applications  programmer  should  be  sure  to
     allocate  AUCLASNAMEMAX  and AUCLASDESCMAX bytes for
     the acname and acdesc members of the  auclassentt  data
     structure.


     The internal representation of an  audituser  entry  is  an
     auclassent  structure  defined in   with the
     following members:

       char        *acname;
       auclasst     acclass;
       char       *acdesc;


RETURN VALUES
     The getauclassnam() and getauclassnamr() functions return a
     pointer  to  a  auclassent  structure if they successfully
     locate the requested entry. Otherwise they return NUL.


     The getauclassent() and getauclassentr() functions return a
     pointer  to  a  auclassent  structure if they successfully
     enumerate an entry. Otherwise they return  NUL,  indicating
     the end of the enumeration.

FILES
     /etc/security/auditclass    file  that  aps   audit   class
                                  numbers to audit class names


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



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     MT-Level                     MT-Safe with exceptions.    
    







SunOS 5.11          Last change: 31 Mar 2005                    2






Security and Auditing Library Functions       getauclassent(3BSM)



     All of the functions described on this man-page are  MT-Safe
     except  getauclassent() and getauclassnam, which are Unsafe.
     The getauclassentr() and getauclassnamr()  functions  have
     the  same  functionality as the Unsafe functions, but have a
     slightly different function call interface to make them  MT-
     Safe.

SEE ALSO
     bsmconv(1M), auditclass(4), auditevent(4), attributes(5)

NOTES
     All information is contained in a static area, so it must be
     copied if it is to be saved.


     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