setregid(2)
_________________________________________________________________
setregid System Call
Set the real-, effective-, and saved-group-ids.
_________________________________________________________________
SYNTAX
int setregid (rgid, egid)
int rgid;
int egid;
PARAMETERS
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 is
not the superuser, he may only set the effective-group-id to the
real-group-id or the saved-group-id. Only the superuser 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 calling process has effective-user-id of superuser,
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
DG/UX 4.00 Page 1
Licensed material--property of copyright holder(s)
setregid(2)
current value.
RETURN VALUE
0 Successful completion.
-1 An error occurred. Errno is set to indicate the
error.
EXCEPTIONS
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
The related system calls: getuid, geteuid, getgid, getegid,
setuid, setgid, setreuid.
DG/UX 4.00 Page 2
Licensed material--property of copyright holder(s)