NAME¶
initgroups - initialize the supplementary group access list
SYNOPSIS¶
#include <grp.h>
#include <sys/types.h>
int initgroups(const char *user, gid_t group);
DESCRIPTION¶
The
initgroups() function initializes the group access list by reading
the group database
/etc/group and using all groups of which
user
is a member. The additional group
group is also added to the list.
RETURN VALUE¶
The
initgroups() function returns 0 on success, or -1 if an error occurs.
ERRORS¶
- EPERM
- The calling process does not have sufficient
privileges.
- ENOMEM
- Insufficient memory to allocate group information
structure.
FILES¶
/etc/group group database file
SVID 3, BSD 4.3
SEE ALSO¶
getgroups(2),
setgroups(2)