Sun Microsystems, Inc.
spacerspacer
spacer   www.sun.com docs.sun.com | | |  
spacer
black dot
   
A   B   C   D   E   F   G   H   I   J   K   L   M   N   O   P   Q   R   S   T   U   V   W   X   Y   Z
    
 
Security and Auditing Library Functionsgetauusernam(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 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, 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 attributes:

ATTRIBUTE TYPEATTRIBUTE VALUE
MT-LevelMT-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 functionality with interfaces that are MT-Safe.


SunOS 5.9Go To TopLast Changed 12 Aug 1999

 
      
      
Copyright 2002 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms.