SETUID(2) System Calls Manual SETUID(2)
NAME
setuid, setgid - set user or group ID's
SYNOPSIS
#include <sys/types.h>
int setuid(uid_t uid)
int setgid(gid_t gid)
DESCRIPTION
Setuid sets the real and effective user ID's of the current process to uid. Unprivileged users may only change both user ID's to the real
user ID; only the super-user may make other changes. Setgid does the same for the real and effective group ID's.
Minix-vmd allows an unprivileged user to change ID's to the original real or effective ID as they were at the time the process was exe-
cuted. Setgid may also set the group ID's to any of the additional group ID's. If one of the remembered user ID's was 0 then any user or
group ID may be chosen.
RETURN VALUE
Upon successful completion, a value of 0 is returned. Otherwise, a value of -1 is returned and errno is set to indicate the error.
ERRORS
[EPERM] The current process is not the super-user and a change other than one of the allowed changes was attempted.
SEE ALSO
getuid(2), getgid(2).
4th Berkeley Distribution May 9, 1985 SETUID(2)