int
setgroups(int ngroups, const gid_t *gidset)
)
sets the group access list of the current user process
according to the array
gidset.
The parameter
ngroups
indicates the number of entries in the array and must be no
more than
{NGROUPS_MAX}.
Only the super-user may set new groups.
This system call affects only secondary groups.
)
call will fail if:
EINVAL]ngroups
is greater than
{NGROUPS_MAX}.
EPERM]EFAULT]gidset
is outside the process
address space.
)
function call appeared in
4.2BSD.