getauusernam

 

---

 
 
 
 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
 
 
 

---