Manual Pages for UNIX Operating System command usage for man getauclassent

Security and Auditing Library Functions       getauclassent(3BSM)



NAME
     getauclassent,   getauclassnam,   setauclass,    endauclass,
     getauclassnam_r, getauclassent_r - get audit_class entry

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

     struct au_class_ent *getauclassnam( const char *name);


     struct au_class_ent *getauclassnam_r( au_class_ent_t *class_int,
          const char *name);


     struct au_class_ent *getauclassent(void);


     struct au_class_ent *getauclassent_r( au_class_ent_t *class_int);


     void setauclass(void);


     void endauclass(void);


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


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


     The getauclassent() function enumerates audit_class entries.
     Successive calls to getauclassent() return either successive
     audit_class entries or NULL.


     The setauclass() function ``rewinds'' to  the  beginning  of
     the  enumeration  of  audit_class  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  audit_class
     processing  is  complete; the system may then close any open
     audit_class file, deallocate storage, and so forth.



SunOS 5.11          Last change: 30 Mar 2010                    1






Security and Auditing Library Functions       getauclassent(3BSM)



     The getauclassent_r() and getauclassnam_r()  functions  both
     return  a  pointer to an audit_class entry as do their simi-
     larly named counterparts.   They  each  take  an  additional
     argument,   a   pointer   to   pre-allocated  space  for  an
     au_class_ent_t, 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  AU_CLASS_NAME_MAX  and AU_CLASS_DESC_MAX bytes for
     the ac_name and ac_desc members of the  au_class_ent_t  data
     structure.


     The internal representation of an audit_class  entry  is  an
     au_class_ent  structure  defined in   with the
     following members:

       char        *ac_name;
       au_class_t     ac_class;
       char       *ac_desc;


RETURN VALUES
     The getauclassnam() and getauclassnam_r() functions return a
     pointer  to  a  au_class_ent  structure if they successfully
     locate the requested entry. Otherwise they return NULL.


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

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


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



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | MT-Level                    | MT-Safe with exceptions.    |
    |_____________________________|_____________________________|







SunOS 5.11          Last change: 30 Mar 2010                    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 getauclassent_r() and getauclassnam_r()  functions  have
     the  same  functionality as the Unsafe functions, but have a
     slightly different function call interface to make them  MT-
     Safe.

SEE ALSO
     audit_class(4), audit_event(4), attributes(5)

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










































SunOS 5.11          Last change: 30 Mar 2010                    3