NAME

getauid, setauid − get and set user audit identity

SYNOPSIS

getauid()

setauid(auid)
int auid;

DESCRIPTION

The getauid() system call returns the audit user ID for the current process.  This value is initially set at login time and inherited by all child processes.  This value does not change when the real/effective user IDs change, so it can be used to identify the logged-in user, even when running a setuid program.  The audit user ID governs audit decisions for a process. 

The setauid() system call sets the audit user ID for the current process.  Only the super-user may successfully execute these calls. 

RETURN VALUE

The getauid() call returns the audit user ID of the current process on successful operation, and returns −1 for all errors. 

The getauid() call returns 0 on successful operation, and −1 for all errors. 

ERRORS

EPERM The process’s effective user ID is not super-user. 

EINVAL The parameter auid is not a valid uid. 

SEE ALSO

getuid(2), setuseraudit(2), audit(8)

Sun Release 4.0  —  Last change: 22 March 1989