setegid(2)                     DG/UX R4.11MU05                    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 calling process has appropriate privilege, effective-group-id
       is set to egid.  If the calling process does not have appropriate
       privilege, 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.

       For systems supporting the DG/UX Capability Option, appropriate
       privilege is defined as having one or more specific capabilities
       enabled in the effective capability set of the calling process.  See
       capdefaults(5) for the default capability for this system call.

       On systems without the DG/UX Capability Option, appropriate privilege
       means that the process has an effective UID of root.  See the
       appropriateprivilege(5) man page for more information.

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), appropriateprivilege(5).
       capdefaults(5).


Licensed material--property of copyright holder(s)