GETGROUPS(2) BSD System Calls Manual GETGROUPS(2)

NAME
     ggeettggrroouuppss - get group access list

SYNOPSIS
     ##iinncclluuddee <>

     int
     ggeettggrroouuppss(int gidsetsize, gidt grouplist[]);

DESCRIPTION
     GGeettggrroouuppss() gets the current group access list of the current user
     process and stores it in the array grouplist[].  The parameter gidsetsize
     indicates the number of entries that may be placed in grouplist[].
     GGeettggrroouuppss() returns the actual number of groups returned in grouplist[].
     No more than {NGROUPSMAX} will ever be returned.  If gidsetsize is 0,
     ggeettggrroouuppss() returns the number of groups without modifying the
     grouplist[] array.

RETURN VALUES
     A successful call returns the number of groups in the group set.  Other-
     wise, a value of -1 is returned and the global integer variable errno is
     set to indicate the error.

EERRRROORRSS
     The possible errors for ggeettggrroouuppss() are:

     [EFAULT]           The argument grouplist specifies an invalid address.

     [EINVAL]           The argument gidsetsize, although non-zero, is smaller
                        than the number of groups in the group set.

LEGACY SYNOPSIS
     ##iinncclluuddee <>
     ##iinncclluuddee <>
     ##iinncclluuddee <>

     The include files  and  are necessary.

SEE ALSO
     setgroups(2), initgroups(3), compat(5)

HISTORY     The ggeettggrroouuppss() function call appeared in 4.2BSD.

4.2 Berkeley Distribution       April 16, 1994       4.2 Berkeley Distribution