SETRUID(3)                  BSD Programmer's Manual                 SETRUID(3)

NAME
     setruid, setrgid - set user and group ID

SYNOPSIS
     #include <sys/types.h>

     int
     setruid(uidt ruid)

     int
     setrgid(gidt rgid)

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

RETURN VALUES
     Upon success, these functions return 0; otherwise -1 is returned.

     If the user is not the super user, or the uid specified is not the real
     or effective ID, these functions return -1.

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

SEE ALSO
     setuid(2),  setgid(2),  seteuid(2),  setegid(2),  getuid(2),  getgid(2)

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

4.2 Berkeley Distribution       March 26, 1993                               1