NAME
seteuid(), setegid() — set effective user and group IDs
SYNOPSIS
#include <unistd.h>
int seteuid(uid_t euid);
int setegid(gid_t egid);
DESCRIPTION
seteuid()
sets the effective user ID of the calling process,
if
euid
is equal to the current real or saved user ID, or
if the process has appropriate privileges.
The real user ID and saved set-user-ID remain unchanged.
setegid()
sets the effective group ID of the calling process,
if
egid
is equal to the current real or saved group ID, or
if the process has appropriate privileges.
The real group ID, saved set-group-ID and any supplementary group
IDs remain unchanged.
RETURN VALUE
Upon successful completion,
seteuid()
and
setegid()
return 0; otherwise, they return -1 and set
errno
to indicate the error.
ERRORS
seteuid()
and
setegid()
fail if any of the following conditions are encountered:
- EINVAL
euid,
or
egid,
is not a valid user or group ID.
- EPERM
The process does not have appropriate privileges and
euid/egid
does not match the real use/group ID or the saved set-user-ID/set-group-ID.
AUTHOR
seteuid()
and
setegid()
were developed by HP.
STANDARDS CONFORMANCE
seteuid(): UNIX 03
setegid(): UNIX 03
Printable version
