INITGROUPS(3C-SVR4) RISC/os Reference Manual  INITGROUPS(3C-SVR4)



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(3C), to get
     the group membership for the user specified by name and then
     initializes the supplementary group access list of the cal-
     ling process using setgroups(2).  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}, subse-
     quent 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.  Oth-
     erwise, a value of -1 is returned and errno is set to indi-
     cate the error.






















                        Printed 11/19/92                   Page 1