setruid(3)

NAME

setruid, setrgid - set user and group ID

LIBRARY

Standard C Library (libc, -lc)

SYNOPSIS

#include <unistd.h>
int
setruid(uid_t ruid);
int
setrgid(gid_t rgid);

DESCRIPTION

The setruid() function (setrgid()) sets the real user ID

(group ID) of
the current process.

RETURN VALUES

The function returns the value 0 if successful; otherwise

the value -1 is
returned and the global variable errno is set to indicate

the error.

COMPATIBILITY

The use of these calls is not portable. Their use is dis

couraged; they
will be removed in the future.

ERRORS

The functions fail if:

[EPERM] The user is not the super user and the ID

specified is

not the real or effective ID.

SEE ALSO

getgid(2), getuid(2), setegid(2), seteuid(2), setgid(2), se

tuid(2)

HISTORY

The setruid() and setrgid() syscalls appeared in 4.2BSD and

were dropped
in 4.4BSD.

BSD June 2, 1993

BSD