NAME    [Toc]    [Back]

       setrgid, setegid - Set the process's group IDs

SYNOPSIS    [Toc]    [Back]

       #include <sys/types.h>

       int setrgid(
                 gid_t rgid ); int setegid(
               gid_t egid );

LIBRARY    [Toc]    [Back]

       Standard C Library (libc)

PARAMETERS    [Toc]    [Back]

       Specifies the value of the real group ID to be set.  Specifies
 the value of the effective group ID to be set.

DESCRIPTION    [Toc]    [Back]

       The setegid() function sets the process's effective  group
       ID  to the value of the egid parameter if the egid parameter
 is equal to the  current  real,  effective,  or  saved
       group ID.

       The setrgid() function sets the process's real group ID to
       the value of the rgid parameter.

       Only the superuser may change the real or effective  group
       ID  to  a value other than the current real or saved group
       ID of the process.

RETURN VALUES    [Toc]    [Back]

       Upon successful completion, the  setegid()  and  setrgid()
       functions  return  a value of 0 (zero). If either function
       fails, a value of -1 is returned and errno is set to indicate
 the error.

ERRORS    [Toc]    [Back]

       If the setrgid() or setegid() function fails, errno is set
       to one of the following values: The rgid or egid parameter
       is  not equal to either the real or saved group IDs of the
       process and the calling process does  not  have  superuser
       privilege.

SEE ALSO    [Toc]    [Back]

       Functions: getgroups(2), setgroups(2), setluid(3),

       Commands: groups(1).



                                                       setrgid(3)