GETGROUPS(2)            COMMAND REFERENCE            GETGROUPS(2)



NAME
     getgroups - get group access list

SYNOPSIS
     #include <sys/param.h>

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

DESCRIPTION
     Getgroups gets the current group access list of the user
     process and stores it in the array gidset.  The parameter
     ngroups points to the the number of entries which may be
     placed in gidset and its contents are modified on return to
     indicate the actual number of groups returned.  No more than
     NGROUPS, as defined in <sys/param.h>, will ever be returned
     in ngroups.

DIAGNOSTICS
     The possible errors for getgroups are:

     [EFAULT]     The argument gidset or ngroups specifies an
                  invalid address.

     [EINVAL]     The size of gidset, as specified by the
                  contents of ngroups, is too small to
                  accommodate the entire group access list.

RETURN VALUE
     Upon successful completion, a value of 0 is returned, and
     gidset and ngroups are modifed as described above.
     Otherwise, a value of -1 is returned and errno is set to
     indicate the error.

SEE ALSO
     setgroups(2), and initgroups(3c).



















Printed 4/6/89                                                  1

%%index%%
na:360,85;
sy:445,839;
de:1284,683;
di:1967,581;
rv:2548,366;
se:2914,178;
%%index%%000000000108