Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
getauusernam(3BSM)  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  getauuser-
       nam_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 au-
       dit_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 succes-
       sive 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 getauuser-
       ent_r().

       The endauuser() function	may be called to indicate that audit_user pro-
       cessing	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	 argu-
       ment 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 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; otherwise it returns NULL,  in-
       dicating	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 attributes:

       +-----------------------------+-----------------------------+
       |      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.

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

SunOS 5.9			  12 Aug 1999		    getauusernam(3BSM)

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUES | USAGE | FILES | ATTRIBUTES | SEE ALSO | NOTES

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=getauusernam&sektion=3bsm&manpath=SunOS+5.9>

home | help