setgid(2)                      DG/UX 5.4R3.00                      setgid(2)


NAME
       setgid - set the real-, effective-, and saved-group-ids

SYNOPSIS
       #include <sys/types.h>

       int  setgid (gid)
       gidt  gid;

   where:
       gid    The value to which the calling process's group-ids are to be
              set

DESCRIPTION
       Setgid sets the real-group-id, effective-group-id, and saved-group-id
       of the calling process to gid, subject to the access control
       constraints described below.

       The value of gid must always be non-negative and less than MAXUID.

ACCESS CONTROL
       If the effective-user-id of the calling process is superuser the
       real-group-id, effective-group-id, and saved_group_id values are all
       set to gid.

       If the effective-user-id of the calling process is not superuser, but
       its real-group-id or its saved_group_id is equal to gid, the
       effective-group-id is set to gid.  The real-group-id and
       saved_group_id are unchanged.

RETURN VALUE
       0      Successful completion.

       -1     An error occurred.  errno is set to indicate the error.

DIAGNOSTICS
       Errno may be set to one of the following error codes:

       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 gid was negative or greater than
                 MAXUID.

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









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