Security and Auditing Library Functions        getauusernam(3BSM)



NAME
     getauusernam,    getauuserent,     setauuser,     endauuser,
     getauusernamr, getauuserentr - get audituser entry

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

     struct auuserent *getauusernam(const char *name);


     struct auuserent *getauuserent(void);


     void setauuser(void);


     void endauuser(void);


     struct auuserent *getauusernamr(auuserentt  *u, const char *name);


     struct auuserent *getauuserentr(auuserentt *u);


DESCRIPTION
     The getauuserent(),  getauusernam(),  getauuserentr(),  and
     getauusernamr()  functions each return an audituser entry.
     Entries can come from any of the sources  specified  in  the
     /etc/nsswitch.conf file (see nsswitch.conf(4)).


     The getauusernam() and getauusernamr() functions search for
     an audituser entry with a given login name name.


     The getauuserent() and getauuserentr() functions  enumerate
     audituser entries; successive calls to these functions will
     return either successive audituser entries or NUL.


     The setauuser() function "rewinds" to the beginning  of  the
     enumeration  of audituser entries.  Calls to getauusernam()
     and  getauusernamr()  may  leave  the  enumeration  in   an
     indeterminate  state, so setauuser() should be called before
     the first call to getauuserent() or getauuserentr().


     The endauuser() function may  be  called  to  indicate  that
     audituser processing is complete; the system may then close



SunOS 5.11          Last change: 31 Mar 2005                    1






Security and Auditing Library Functions        getauusernam(3BSM)



     any open audituser file, deallocate storage, and so forth.


     The getauuserentr()  and  getauusernamr()  functions  both
     take  as  an  argument  a  pointer to an auuserent that is
     returned on successful function calls.


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

       char        *auname;
       aumaskt   aualways;
       aumaskt   aunever;


RETURN VALUES
     The  getauusernam()  function  returns  a   pointer   to   a
     auuserent   structure   if  it  successfully  locates  the
     requested entry. Otherwise it returns NUL.


     The  getauuserent()  function  returns  a   pointer   to   a
     auuserent  structure  if  it  successfully  enumerates  an
     entry. Otherwise it returns NUL, indicating the end of  the
     enumeration.

USAGE
     The functionality described on this manual page is available
     only   if  the  Solaris  Auditing  has  been  enabled.   See
     bsmconv(1M) for more information.

FILES
     /etc/security/audituser    file that stores per-user  audit
                                 event mask


     /etc/passwd                 file  that  stores  user  ID  to
                                 username mappings


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










SunOS 5.11          Last change: 31 Mar 2005                    2






Security and Auditing Library Functions        getauusernam(3BSM)



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


SEE ALSO
     bsmconv(1M), getpwnam(3C), audituser(4),  nsswitch.conf(4),
     passwd(4), attributes(5)

NOTES
     All information for the  getauuserent()  and  getauusernam()
     functions  is  contained  in  a  static  area, so it must be
     copied if it is to be saved.


     The getauusernam() and getauuserent() functions  are  Unsafe
     in  multithreaded  applications.  The  getauusernamr()  and
     getauuserentr() functions provide  the  same  functionality
     with interfaces that are MT-Safe.


































SunOS 5.11          Last change: 31 Mar 2005                    3