NAME
initgroups - initialize the supplementary group access list
SYNOPSIS
#include <sys/types.h>
#include <grp.h>
I int initgroups(const char * user , gid_t group );
DESCRIPTION
The
R 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.
The
user
argument must be non-NULL.
RETURN VALUE
The
R initgroups ()
function returns 0 on success.
On error, -1 is returned, and
errno
is set appropriately.
ERRORS
ENOMEM
Insufficient memory to allocate group information structure.
EPERM
The calling process has insufficient privilege.
See the underlying system call
setgroups(2).
FILES
/etc/group group database file
CONFORMING TO
SVr4, 4.3BSD
NOTES
The prototype for
R initgroups ()
is only available if
_BSD_SOURCE
is defined.
SEE ALSO