setreuid(2)
_________________________________________________________________
setreuid System Call
Set the real-, effective-, and saved-user-ids.
_________________________________________________________________
SYNTAX
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.
DG/UX 4.00 Page 1
Licensed material--property of copyright holder(s)
setreuid(2)
-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.
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.
DG/UX 4.00 Page 2
Licensed material--property of copyright holder(s)