Manual Pages  — SETRUID

setruid, setrgid – set user and group ID

LIBRARY SYNOPSIS DESCRIPTION RETURN VALUES COMPATIBILITY ERRORS SEE ALSO HISTORY

Standard C Library (libc, -lc)

#include <unistd.h>

int
setruid(uid_t ruid);

int
setrgid(gid_t rgid);

The setruid() function (setrgid()) sets the real user ID (group ID) of the current process.

Upon successful completion, the value 0 is returned; otherwise the value -1 is returned and the global variable errno is set to indicate the error.

The use of these calls is not portable. Their use is discouraged; they will be removed in the future.

The functions fail if:

[EPERM]
	The user is not the super user and the ID specified is not the real or effective ID.

The setruid() and setrgid() syscalls appeared in BSD 4.2 and were dropped in BSD 4.4 .