setregid(2) — DG/UX R4.11



setregid(2)                       SDK R4.11                      setregid(2)


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

SYNOPSIS
       #include <sys/types.h>

       int  setregid (rgid, egid)
       gidt  rgid;
       gidt  egid;

   where:
       rgid      The value to which the real-group-id should be set

       egid      The value to which the effective-group-id should be set

DESCRIPTION
       The real-group-id and effective-group-id's of the calling process are
       set according to the arguments.  If rgid or egid is -1, the current
       value of the real-group-id is used.  If the caller does not have
       appropriate privilege, he may only set the effective-group-id to the
       real-group-id or the saved-group-id.  Only a user with appropriate
       privilege may make other changes.  If after changing the real- and
       effective-group-id's, the calling process's effective-group-id no
       longer matches either its real- or saved-group-id's, its
       saved-group-id is set to the value of its effective-group-id.  If the
       real-group-id is changed and the calling process's group list is not
       empty, the old real-group-id is deleted from the group list and the
       new real-group-id is added.

       Note that since the effective-group-id is implicitly a part of the
       group list, if this call changes the effective-group-id it also
       changes the group list.

ACCESS CONTROL
       If the the calling process has appropriate privilege, setting of the
       real- and effective-user-ids is not restricted.

       Otherwise, the effective-user-id may be set only to its current value
       or to the current value of the real-user-id or to the saved-user-id
       value.  The real-user-id may be set only to its current value.

       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.

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     The above specified access check failed.

       EINVAL    The supplied value of rgid or egid was less than -1 or
                 greater than MAXUID.

SEE ALSO
       getuid(2), geteuid(2), getgid(2), getegid(2), setuid(2), setgid(2),
       setreuid(2), appropriateprivilege(5).
       capdefaults(5).


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

Related Articles
