GETAUUSERNAM(3BSM)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 Solaris Auditing has been enabled. See bsmconv(1M) for more infor‐
mation.
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 │
├───────────────┼─────────────────────────┤
│MT-Level │ MT-Safe with exceptions │
└───────────────┴─────────────────────────┘
SEE ALSObsmconv(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.
Mar 31, 2005 GETAUUSERNAM(3BSM)