setrgid(3)setrgid(3)NAME
setrgid, setegid - Set the process's group IDs
SYNOPSIS
#include <sys/types.h>
int setrgid(
gid_t rgid ); int setegid(
gid_t egid );
LIBRARY
Standard C Library (libc)
PARAMETERS
Specifies the value of the real group ID to be set. Specifies the
value of the effective group ID to be set.
DESCRIPTION
The setegid() function sets the process's effective group ID to the
value of the egid parameter if the egid parameter is equal to the cur‐
rent real, effective, or saved group ID.
The setrgid() function sets the process's real group ID to the value of
the rgid parameter.
Only the superuser may change the real or effective group ID to a value
other than the current real or saved group ID of the process.
RETURN VALUES
Upon successful completion, the setegid() and setrgid() functions
return a value of 0 (zero). If either function fails, a value of -1 is
returned and errno is set to indicate the error.
ERRORS
If the setrgid() or setegid() function fails, errno is set to one of
the following values: The rgid or egid parameter is not equal to either
the real or saved group IDs of the process and the calling process does
not have superuser privilege.
SEE ALSO
Functions: getgroups(2), setgroups(2), setluid(3),
Commands: groups(1).
setrgid(3)