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.