setreuid(2) DG/UX 4.30 setreuid(2)
NAME
setreuid - Set the real-, effective-, and saved-user-ids.
SYNOPSIS
int setreuid (ruid, euid)
int ruid;
int euid;
PARAMETERS
ruid The value to which the real-user-id should be
set.
euid The value to which the effective-user-id
should be set.
DESCRIPTION
The real-user-id and effective-user-id's of the calling
process are set according to the arguments. If <ruid> or
<euid> is -1, the current value of the real-user-id is used.
If the caller is not the superuser, he may only set the
effective-user-id to the real-user-id or the saved_user_id.
Only the superuser may make other changes. If after
changing the real- and effective-user-id's, the calling
process's effective-user-id no longer matches either its
real- or saved-user-id's, its saved-user-id is set to the
value of its effective-user-id.
ACCESS CONTROL
If the calling process has effective-user-id of superuser,
setting of the real- and effective-user-ids is not
restricted.
Otherwise, the effective-user-id may be set only to its
current value or to the current value of the real-user-id or
to the saved-user-id value. The real-user-id may be set
only to its current value.
RETURN VALUE
0 Successful completion.
-1 An error occurred. Errno is set to indicate
the error.
EXCEPTIONS
Errno may be set to one of the following error codes:
EPERM The above specified access check failed.
Licensed material--property of copyright holder(s) Page 1
setreuid(2) DG/UX 4.30 setreuid(2)
EINVAL The supplied value of <ruid> or <euid> was
less than -1 or greater than MAXUID.
SEE ALSO
The related system calls: getuid, geteuid, getgid, getegid,
setuid, setgid.
Licensed material--property of copyright holder(s) Page 2