LIBRARY
Lb libcSYNOPSIS
In sys/param.h In unistd.h Ft int Fn setgroups int ngroups const gid_t *gidsetDESCRIPTION
The Fn 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_MAX}+1Only the super-user may set a new group list.
RETURN VALUES
Rv -std setgroupsERRORS
The Fn 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_MAX}+1 limit.
- Bq Er EFAULT
- The address specified for Fa gidset is outside the process address space.
HISTORY
The Fn setgroups system call appeared in BSD 4.2