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.5                   April 16, 1994                   DragonFly 3.5