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)