Security and Auditing Library Functions        getauusernam(3BSM)

NAME
     getauusernam,  getauuserent,  setauuser,  endauuser  -   get
     audit_user entry

SYNOPSIS
     cc [ flag ... ] file ... -lbsm  -lsocket  -lnsl  -lintl [ library ... ]
     #include <sys/param.h>
     #include <bsm/libbsm.h>

     struct au_user_ent *getauusernam(const char *name);

     struct au_user_ent *getauuserent(void);

     void setauuser(void);

     void endauuser(void);

     struct au_user_ent *getauusernam_r(au_user_ent_t  * u, const
     char *name);

     struct au_user_ent *getauuserent_r(au_user_ent_t *u);

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

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

     The getauuserent() and getauuserent_r() functions  enumerate
     audit_user entries; successive calls to these functions will
     return either successive audit_user entries or NULL.

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

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

     The getauuserent_r()  and  getauusernam_r()  functions  both
     take  an  argument  u, which is a pointer to an au_user_ent.
     This is the pointer that is returned on successful  function
     calls.

     The internal representation of an  audit_user  entry  is  an
     au_user_ent  structure  defined  in  <bsm/libbsm.h> with the

SunOS 5.8           Last change: 12 Aug 1999                    1

Security and Auditing Library Functions        getauusernam(3BSM)

     following members:

     char        *au_name;
     au_mask_t   au_always;
     au_mask_t   au_never;

RETURN VALUES
     The getauusernam() function returns a pointer to  a   struct
     au_user_ent  if it successfully locates the requested entry;
     otherwise it returns NULL.

     The getauuserent() function returns a pointer to  a   struct
     au_user_ent  if  it successfully enumerates an entry; other-
     wise it returns NULL, indicating the end of the enumeration.

USAGE
     The functionality described in this manual page is available
     only  if  the  Basic Security Module (BSM) has been enabled.
     See bsmconv(1M) for more information.

FILES
     /etc/security/audit_user
           stores per-user audit event mask

     /etc/passwd
           stores user-id to username mappings

     /etc/security/audit_user
           stores per-user audit event mask

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

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

SEE ALSO
     bsmconv(1M), getpwnam(3C), audit_user(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.

SunOS 5.8           Last change: 12 Aug 1999                    2

Security and Auditing Library Functions        getauusernam(3BSM)

     The getauusernam() and getauuserent() functions are not  MT-
     safe.  The   getauusernam_r() and getauuserent_r() functions
     provide the same functionality with interfaces that are  MT-
     Safe.

SunOS 5.8           Last change: 12 Aug 1999                    3