setgroups.2freebsd

Langue: en

Autres versions - même langue

Version: 266198 (debian - 07/07/09)

Section: 2 (Appels système)

Sommaire


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 as defined in In sys/param.h .

Only the super-user may set new groups.

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