initgroups(3C)                                        initgroups(3C)


       NAME
             initgroups - initialize the supplementary group access list

       SYNOPSIS
             #include <grp.h>
             #include <sys/types.h>
             int initgroups (const char *name, gid_t basegid)

       DESCRIPTION
             initgroups reads the group file, using getgrent, to get the
             group membership for the user specified by name and then
             initializes the supplementary group access list of the calling
             process using setgroups.  The basegid group ID is also
             included in the supplementary group access list.  This is
             typically the real group ID from the password file.

             While scanning the group file, if the number of groups,
             including the basegid entry, exceeds {NGROUPS_MAX}, subsequent
             group entries are ignored.

          Return Values
             Upon successful completion, a value of 0 is returned.
             Otherwise, a value of -1 is returned and errno is set to
             indicate the error.

       REFERENCES
             getgrent(3C), getgroups(2)





















                           Copyright 1994 Novell, Inc.               Page 1