ultrix man page for initgroups

initgroups(3x)															    initgroups(3x)

Name
       initgroups - initialize group access list

Syntax
       initgroups(name, basegid)
       char *name;
       int basegid;

Description
       The subroutine reads through the group file and sets up, using the 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.

Restrictions
       The subroutine uses the routines based on If the invoking program uses any of these routines, the group structure will  be  overwritten	in
       the call to

Return Values
       The returns -1 if it was not invoked by the superuser.

Files
       /etc/group

See Also
       setgroups(2)

																    initgroups(3x)