SETGROUPS(2) SETGROUPS(2)
NAME
setgroups - set group access list
SYNOPSIS
#include <sys/param.h>
int setgroups(ngroups, gidset)
int ngroups;
gidt *gidsets;
DESCRIPTION
setgroups 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 , as defined in <sys/param.h> .
Only the superuser may set new groups.
RETURN VALUE
A 0 value is returned on success, -1 on error, with a error
code stored in errno.
ERRORS
The setgroups call will fail if:
[EINVAL] The value of ngroups is greater than NGROUPS.
[EPERM] The caller is not the superuser.
[EFAULT] The address specified for gidset is outside the
process address space.
SEE ALSO
getgroups (2).
Page 1 May 1989