getgrouplist (3) ( Linux man: Библиотечные вызовы )
BSD mandoc
NAME
getgrouplist
- calculate group access list
LIBRARY
Lb libc
SYNOPSIS
#include <unistd.h> int
getgrouplist (const char *name gid_t basegid gid_t *groups int *ngroups);
DESCRIPTION
The
getgrouplist ();
function reads through the group file and calculates
the group access list for the user specified in
Fa name .
The
Fa basegid
is automatically included in the groups list.
Typically this value is given as
the group number from the password file.
The resulting group list is returned in the array pointed to by
Fa groups .
The caller specifies the size of the
Fa groups
array in the integer pointed to by
Fa ngroups ;
the actual number of groups found is returned in
Fa ngroups .
RETURN VALUES
The
getgrouplist ();
function
returns -1 if the size of the group list is too small to
hold all the user's groups.
Here, the group array will be filled with as many groups as will fit.
The
getgrouplist ();
function first appeared in
BSD 4.4
BUGS
The
getgrouplist ();
function
uses the routines based on
getgrent(3).
If the invoking program uses any of these routines,
the group structure will
be overwritten in the call to
getgrouplist (.);
