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.

         initgroups will fail and not change the supplementary group access
         list if:

         EPERM          The effective user ID is not super-user.

   SEE ALSO
         setgroups(2), getgrent(3C)

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






















   8/91                                                                 Page 1