DragonFly On-Line Manual Pages


SETGROUPS(2)		 DragonFly System Calls Manual		  SETGROUPS(2)

NAME

setgroups -- set group access list

LIBRARY

Standard C Library (libc, -lc)

SYNOPSIS

#include <sys/param.h> #include <unistd.h> int setgroups(int ngroups, const gid_t *gidset);

DESCRIPTION

Setgroups() sets the group access list of the current user process according to the array gidset. The parameter ngroups indicates the num- ber of entries in the array and must be no more than NGROUPS, as defined in <sys/param.h>. Only the super-user may set new groups.

RETURN VALUES

The setgroups() function returns the value 0 if successful; otherwise the value -1 is returned and the global variable errno is set to indicate the error.

ERRORS

The setgroups() call will fail if: [EPERM] The caller is not the super-user. [EFAULT] The address specified for gidset is outside the process address space.

SEE ALSO

getgroups(2), initgroups(3)

HISTORY

The setgroups() function call appeared in 4.2BSD. DragonFly 3.9 April 16, 1994 DragonFly 3.9