SETRUID(2)                       System Calls                       SETRUID(2)

NAME

       setruid, setrgid - set user and group ID

SYNOPSIS

       #include <sys/types.h>
       #include <unistd.h>

       int setruid (uid_t ruid);
       int setrgid (gid_t rgid);

DESCRIPTION

       The setruid function sets the real user ID of the current process.

       The setrgid function sets the real 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
       will 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.2 BSD and were dropped
       in 4.4BSD.



GNO                             19 January 1997                     SETRUID(2)