getgroups man page on FreeBSD

Man page or keyword search:  
man Server   9747 pages
apropos Keyword Search (all sections)
Output format
FreeBSD logo
[printable version]

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

NAME
     getgroups — get group access list

LIBRARY
     Standard C Library (libc, -lc)

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

     int
     getgroups(int gidsetlen, gid_t *gidset);

DESCRIPTION
     The getgroups() system call gets the current group access list of the
     user process and stores it in the array gidset.  The gidsetlen argument
     indicates the number of entries that may be placed in gidset.  The
     getgroups() system call returns the actual number of groups returned in
     gidset.  At least one and as many as {NGROUPS_MAX}+1 values may be
     returned.	If gidsetlen is zero, getgroups() returns the number of sup‐
     plementary group IDs associated with the calling process without modify‐
     ing the array pointed to by gidset.

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)

STANDARDS
     The getgroups() system call conforms to IEEE Std 1003.1-2008 (“POSIX.1”).

HISTORY
     The getgroups() system call appeared in 4.2BSD.

BSD				 March 5, 1999				   BSD
[top]

List of man pages available for FreeBSD

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
...................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net