getauduser(3)getauduser(3)NAMEgetauduser - retrieve the accountable user for the current process
SYNOPSISDESCRIPTION
retrieves the accountable user for the current process and saves the
information into the buffer pointed to by user. It also retrieves the
time of authentication and saves it into the buffer pointed to by
stime, if the information is available. Caller must set usize and
tsize to the size of the user and the stime buffers. Note that the two
buffers are always null terminated, even if it results in loss of some
data.
Programs using this routine must be compiled with
Security Restrictions
This call requires the user be superuser or possess privilege. See
privileges(5) for details.
RETURN VALUE
returns the following values:
n Successful completion. n is the length of the retrieved
login name, excluding the null byte. If n is less than
usize, the login name is retrieved without truncation.
Otherwise, usize -1 bytes of login name are copied into
user, and user is null terminated. The caller needs to
retry with a larger buffer.
Failure.
is set to indicate the error.
ERRORS
If fails, is set to one of the following values:
The caller is not a superuser or a privileged process.
The size of stime buffer is smaller than See
Unrecognized
EXAMPLESAUTHOR
was developed by HP.
The return values and null padding semantics for this system call are
chosen such that a chance for buffer overflows in a C program is mini‐
mized. These semantics were inspired by of C99 and and as they
appeared in OpenBSD.
SEE ALSOgetaudid(2), setaudid(2), setauduser(3), audit(5), privileges(5).
getauduser(3)