The
setgroups ();
system call
sets the group access list of the current user process
according to the array
Fa gidset .
The
Fa ngroups
argument
indicates the number of entries in the array and must be no
more than
NGROUPS
as defined in
In sys/param.h .
Only the super-user may set new groups.
RETURN VALUES
Rv -std setgroups
ERRORS
The
setgroups ();
system call will fail if:
Bq Er EPERM
The caller is not the super-user.
Bq Er EINVAL
The number specified in the
Fa ngroups
argument is larger than the
NGROUPS
limit.
Bq Er EFAULT
The address specified for
Fa gidset
is outside the process
address space.
