GETGROUPS(3P) GETGROUPS(3P)
NAME
getgroups - get group access list
SYNOPSIS
#include <sys/types.h>
#include <sys/param.h>
int getgroups(gidsetlen, gidset)
int gidsetlen;
gidt *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 number of entries that may be placed
in gidset.
getgroups returns the actual number of groups returned in
gidset . No more than NGROUPSMAX , as defined in <limits.h>
, will ever be returned. If gidsetlen is zero, getgroups
returns the number of supplementary group IDs associated
with the calling process without modifying the array pointed
to by gidset.
RETURN VALUE
If the getgroups is successful the number of groups in the
group set will be returned. If an error is detected, -1
will be returned and errno will be set to indicate the
error.
ERRORS
If any of the following conditions occur, -1 will be
returned and errno set to the corresponding value:
[EINVAL] The argument gidsetlen is smaller than the
number of groups in the group set.
[EFAULT] The argument gidset specifies an invalid
address.
Page 1 May 1989
GETGROUPS(3P) GETGROUPS(3P)
SEE ALSO
setgroups (2), initgroups (3X).
Page 2 May 1989