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);

AVAILABILITY

The functionality described in this man page is available only if the Basic Security Module (BSM) has been enabled.  See bsmconv(1M) for more information. 

DESCRIPTION

getauuserent() and getauusernam() each return an audit_user entry. 

getauusernam() searches for an audit_user entry with a given login name name. 

getauuserent() enumerates audit_user entries:  successive calls to getauuserent() will return either successive audit_user entries or NULL. 

setauuser() “rewinds” to the beginning of the enumeration of audit_user entries.  Calls to getauusernam() may leave the enumeration in an indeterminate state, so setauuser() should be called before the first getauuserent(). 

endauuser() 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 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_tau_always;
au_mask_tau_never;

RETURN VALUES

getauusernam() returns a pointer to a struct au_user_ent if it successfully locates the requested entry; otherwise it returns NULL. 

getauuserent() 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. 

FILES

/etc/security/audit_user

/etc/passwd

SEE ALSO

bsmconv(1M), getpwnam(3C), audit_user(4), passwd(4)

NOTES

All information is contained in a static area, so it must be copied if it is to be saved. 

Sun Microsystems  —  Last change: 6 May 1993