setgroups(2) set group access list

LIBRARY

Lb libc

SYNOPSIS

In sys/param.h In unistd.h Ft int Fn setgroups int ngroups const gid_t *gidset

DESCRIPTION

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}+1

Only the super-user may set a new group list.

RETURN VALUES

Rv -std setgroups

ERRORS

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