initgroups(3P)   INTERACTIVE UNIX System (POSIX)   initgroups(3P)



          NAME
               initgroups - initialize group access list

          SYNOPSIS
               int initgroups(name, basegid)
               char *name;
               gid_t basegid;

          DESCRIPTION
               The initgroups command reads through the group file and sets
               up, using the setgroups(2P) 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.  The number of
               groups set is returned.

          FILES
               /etc/group

          SEE ALSO
               setgroups(2P).

          DIAGNOSTICS
               initgroups returns -1 if it was not invoked by the superuser
               (root), or if there are more groups than NGROUPS_MAX.

          BUGS
               initgroups uses the routines based on getgrent(3P).  If the
               invoking program uses any of these routines, the group
               structure will be overwritten in the call to initgroups.

























          Rev. 1.1                                                   Page 1