INITGROUPS
Section: Linux Programmer's Manual (3)
Updated: April 5, 1993
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
CONFORMING TO
SVID 3, BSD 4.3
SEE ALSO
getgroups(2), setgroups(2)