setgroups(2)                                         setgroups(2)



NAME
     setgroups - sets group access list

SYNOPSIS
     #include <sys/param.h>

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

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

     Only the superuser may set new groups.

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

     The setgroups call will fail if

     EINVAL
          The value of ngroups is greater than NGROUPS.

     EPERM
          The caller is not the superuser.

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

SEE ALSO
     getgroups(2), initgroups(3X)




















January 1992                                                    1