setregid(2)setregid(2)NAMEsetregid - sets the real and effective group IDs
SYNOPSISDESCRIPTION
sets the real and effective group IDs of the calling process.
Only a privileged process can set the real group ID and/or the effec‐
tive group ID to any valid value. A nonprivileged process can set the
real group ID to the saved set-group-ID from one of the exec family of
functions, or the effective group ID to either the saved set-group-ID
or the real group ID.
Any supplementary group IDs of the calling process remain unchanged.
Argument rgid is the read group ID value to be set with. If rgid is
set to the real group ID is not be changed.
Argument egid is the effective group ID value to be set with. If egid
is set to -1, the effective group ID is not changed.
The real and effective group IDs may be set to different values in the
same call.
Security Restrictions
Some or all of the actions associated with this system call require the
privilege (CHSUBJIDENT). Processes owned by the superuser will have
this privilege. Processes owned by other users may have this privi‐
lege, depending on system configuration.
See privileges(5) for more information about privileged access on sys‐
tems that support fine-grained privileges.
RETURN VALUE
Upon successful completion is set to Otherwise, errno is set to indi‐
cate the type of error and neither group IDs are changed.
ERRORS
is set to one of the following values if the corresponding condition is
detected.
The value of the
rgid or egid argument is invalid or out-of-range.
The process does NOT have all the appropriate privileges other
than to change the real group ID to the saved set-group-
ID, or to change the effective group ID to either the
real group ID or the saved set-group-ID.
AUTHOR
was developed by the University of California, Berkeley and HP.
SEE ALSOexec(2), geteuid(2), getgid(2), getuid(2), setegid(2), setgid(2),
setreuid(2), setuid(2).
setregid(2)