GETGROUPS(2-POSIX)  RISC/os Reference Manual   GETGROUPS(2-POSIX)



NAME
     getgroups - get group access list

SYNOPSIS
     #include <sys/types.h>

     int getgroups(gidsetsize, gidset)
     int gidsetsize;
     gidt grouplist[];

DESCRIPTION
     getgroups fills in the array grouplist with the supplemen-
     tary group IDs of the calling process.  The parameter gid-
     setsize indicates the number of entries that may be placed
     in grouplist.  getgroups returns the actual number of sup-
     plementary group IDs returned in grouplist.  No more than
     {NGROUPS_MAX} will ever be returned.

     If gidsetsize is zero, getgroups returns the number of sup-
     plementary group IDs associated with the calling process
     without modifying the array indicated by grouplist.

RETURN VALUE
     A successful call returns the number of supplementary group
     IDs.  A value of -1 indicates that an error occurred, and
     the error code is stored in the global variable errno.

ERRORS
     The possible errors for getgroup are:

     [EINVAL]            The argument gidsetsize is not zero and
                         is smaller than the number of supplemen-
                         tary group IDs.

     [EFAULT]            The argument grouplist specifies an
                         invalid address.

SEE ALSO
     setgid(2).
















                         Printed 1/15/91                   Page 1