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 executed. 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).