INITGROUPS(3)             386BSD Programmer's Manual             INITGROUPS(3)

NAME
     initgroups - initialize group access list

SYNOPSIS
     #include <unistd.h>

     int
     initgroups(const char *name, int basegid)

DESCRIPTION
     The initgroups() function reads through the group file and sets up, using
     the setgroups(2) call, the group access list for the user specified in
     name. The basegid is automatically included in the groups list.
     Typically this value is given as the group number from the password file.

RETURN VALUES
     The initgroups() function returns -1 if it was not invoked by the super-
     user.

FILES
     /etc/group

SEE ALSO
     setgroups(2)

HISTORY
     The initgroups function appeared in 4.2BSD.

BUGS
     The initgroups() 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 initgroups().

4.2 Berkeley Distribution       April 19, 1991                               1