setegid

###

###

###

###

###

###

###

###

    SETREGID(2)         Linux Programmer's Manual         SETREGID(2)

    NAME
           setregid, setegid - set real and / or effective group ID

    SYNOPSIS
           #include <unistd.h>

           int setregid(gid_t rgid, gid_t egid);
           int setegid(gid_t egid);

    DESCRIPTION
           setregid sets real and effective group ID's of the current
           process.  Un-privileged users may change the real group ID
           to the effective group ID and vice-versa.

           Prior  to  Linux  1.1.38, the saved ID paradigm, when used
           with setregid or setegid was broken.  Starting at  1.1.38,
           it is also possible to set the effective group ID from the
           saved user ID.

           Only the super-user may make other changes.

           Supplying a value of -1 for either the real  or  effective
           group ID forces the system to leave that ID unchanged.

           Currently   (libc-4.x.x),  setegid(egid)  is  functionally
           equivalent to setregid(-1, egid).

           If the real group ID is changed or the effective group  ID
           is set to a value not equal to the previous real group ID,
           the saved group ID will be set to the new effective  group
           ID.

    RETURN VALUE
           On  success,  zero is returned.  On error, -1 is returned,
           and errno is set appropriately.

    ERRORS
           EPERM   The current process  is  not  the  super-user  and
                   changes  other  than  (i)  swapping  the effective
                   group ID with the real group ID  or  (ii)  setting
                   one to the value of the other or (iii) setting the
                   effective group ID to the value of the saved group
                   ID was specified.

    HISTORY
           The setregid function call appeared in BSD 4.2.

    CONFORMING TO
           BSD 4.3

### SEE ALSO

getgid, setgid,

###

    Linux 1.1.38             2nd August 1994                        1

Top | Master Index | Keywords | Functions

This manual page was brought to you by mjl_man V-2.0