initgroups(3C)                   UNIX System V                   initgroups(3C)


NAME
      initgroups - initialize the supplementary group access list

SYNOPSIS
      #include <grp.h>
      #include <sys/types.h>

      int initgroups (const char *name, gidt 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 {NGROUPSMAX}, subsequent group entries are
      ignored.

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

      EPERM          The effective user id is not superuser.

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.























10/89                                                                    Page 1