setegid(2)                       DG/UX 5.4.2                      setegid(2)


NAME
       setegid - set the effective group id of the current process

SYNOPSIS
       #include <sys/types.h>
       pidt setegid(gidt egid);

   where:
       egid   The effective group identifier

DESCRIPTION
       If the effective-user-id of the calling process is superuser,
       effective-group-id is set to egid.  If the effective-user-id of the
       calling process is not superuser, but its real-group-id or its
       effective-group-id or its saved-group-id is equal to egid, the
       effective-group-id is set to egid.

ACCESS CONTROL
       See the description above.

RETURN VALUE
       Upon successful completion, the function setegid returns zero.
       Otherwise, it returns -1 and sets errno to indicate an error.

DIAGNOSTICS
       Under the following conditions, the function setegid fails and sets
       errno to:

       EPERM     An attempt was made to set the effective-group-id to a
                 value not permitted by the access control restrictions
                 described above.

       EINVAL    The supplied value of egid was negative or greater than the
                 maximum allowable user id.

SEE ALSO
       getuid(2), geteuid(2), getgid(2), setuid(2), setgid(2),  setregid(2),
       setreuid(2).



















Licensed material--property of copyright holder(s)                         1