Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   6284 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

GETGROUPS(2)		    BSD Programmer's Manual		  GETGROUPS(2)

NAME
     getgroups - get group access list

SYNOPSIS
     #include <sys/param.h>
     #include <unistd.h>

     int
     getgroups(int gidsetlen, gid_t *gidset);

DESCRIPTION
     Getgroups() gets the current group access list of the user process and
     stores it in the array gidset. The parameter gidsetlen indicates the num-
     ber of entries that may be placed in gidset. Getgroups() returns the ac-
     tual number of groups returned in gidset. No more than NGROUPS, as de-
     fined in <sys/param.h>, will ever be returned.

RETURN VALUES
     A successful call returns the number of groups in the group set.  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 getgroups() are:

     [EINVAL]	   The argument gidsetlen is smaller than the number of groups
		   in the group set.

     [EFAULT]	   The argument gidset specifies an invalid address.

SEE ALSO
     setgroups(2),  initgroups(3)

HISTORY
     The getgroups function call appeared in 4.2BSD.

4.2 Berkeley Distribution	April 16, 1994				     1

                             _         _         _ 
                            | |       | |       | |     
                            | |       | |       | |     
                         __ | | __ __ | | __ __ | | __  
                         \ \| |/ / \ \| |/ / \ \| |/ /  
                          \ \ / /   \ \ / /   \ \ / /   
                           \   /     \   /     \   /    
                            \_/       \_/       \_/ 

Vote for polarhome