setgroups.2freebsd

Langue: en

Autres versions - même langue

Version: 338535 (ubuntu - 24/10/10)

Section: 2 (Appels système)


BSD mandoc

NAME

setgroups - 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.

SEE ALSO

getgroups(2), initgroups(3)

HISTORY

The Fn setgroups system call appeared in BSD 4.2