getauusernam man page on SunOS

Man page or keyword search:  
man Server   20652 pages
apropos Keyword Search (all sections)
Output format
SunOS logo
[printable version]

getauusernam(3BSM)  Security and Auditing Library Functions getauusernam(3BSM)

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

SYNOPSIS
       cc [ flag... ] file... -lbsm   -lsocket	  -lnsl	  [ 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
       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 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	as  an
       argument	 a  pointer  to	 an au_user_ent 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 au_user_ent struc‐
       ture if it successfully	locates	 the  requested	 entry.	 Otherwise  it
       returns NULL.

       The  getauuserent()  function returns a pointer to a au_user_ent struc‐
       ture if it successfully enumerates an entry. Otherwise it returns NULL,
       indicating the end of the enumeration.

USAGE
       The  functionality  described  on 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	   file that stores per-user audit event mask

       /etc/passwd		   file	 that  stores user ID to username map‐
				   pings

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

       ┌─────────────────────────────┬─────────────────────────────┐
       │      ATTRIBUTE TYPE	     │	    ATTRIBUTE VALUE	   │
       ├─────────────────────────────┼─────────────────────────────┤
       │Interface Stability	     │Committed (Obsolete)	   │
       ├─────────────────────────────┼─────────────────────────────┤
       │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  Unsafe  in	multi‐
       threaded	 applications. The getauusernam_r() and getauuserent_r() func‐
       tions provide the same functionality with interfaces that are MT-Safe.

       These functions are Obsolete and may be replaced with equivalent	 func‐
       tionality in a future release.

SunOS 5.10			  14 May 2010		    getauusernam(3BSM)
[top]

List of man pages available for SunOS

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net