ADC Home > Reference Library > Reference > Mac OS X > Mac OS X Man Pages
|
This document is a Mac OS X manual page. Manual pages are a command-line technology for providing documentation. You can view these manual pages locally using the man(1) command. These manual pages come from many different sources, and thus, have a variety of writing styles. For more information about the manual page format, see the manual page for manpages(5). |
GETGROUPS(2) BSD System Calls Manual GETGROUPS(2) NAME getgroups -- get group access list SYNOPSIS #include <unistd.h> int getgroups(int gidsetsize, gid_t grouplist[]); DESCRIPTION Getgroups() 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[]. Getgroups() returns the actual number of groups returned in grouplist[]. No more than {NGROUPS_MAX} will ever be returned. If gidsetsize is 0, getgroups() 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, Otherwise, wise, a value of -1 is returned and the global integer variable errno is set to indicate the error. ERRORS The possible errors for getgroups() 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 #include <sys/param.h> #include <sys/types.h> #include <unistd.h> The include files <sys/param.h> and <sys/types.h> are necessary. SEE ALSO setgroups(2), initgroups(3), compat(5) HISTORY The getgroups() function call appeared in 4.2BSD. 4.2 Berkeley Distribution April 16, 1994 4.2 Berkeley Distribution |