NAME    [Toc]    [Back]

     setgroups - set group access list

SYNOPSIS    [Toc]    [Back]

     #include <sys/types.h>
     #include <unistd.h>

     int
     setgroups(int ngroups, const gid_t *gidset);

DESCRIPTION    [Toc]    [Back]

     setgroups() 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 superuser may set new groups.

RETURN VALUES    [Toc]    [Back]

     A 0 value is returned on success, -1 on error, with an error
code stored
     in errno.

ERRORS    [Toc]    [Back]

     The setgroups() call will fail if:

     [EINVAL]       The  value  of  ngroups   is   greater   than
{NGROUPS_MAX}.

     [EPERM]       The caller is not the superuser.

     [EFAULT]       The  address  specified for gidset is outside
the process address
 space.

SEE ALSO    [Toc]    [Back]

     getgroups(2), setgid(2), setregid(2), initgroups(3)

HISTORY    [Toc]    [Back]

     The setgroups() function call appeared in 4.2BSD.

OpenBSD     3.6                          April      16,      1994