INITGROUPS(3)	    UNIX Programmer's Manual	    INITGROUPS(3)



NAME
     initgroups - initialize group access list

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

DESCRIPTION
     _I_n_i_t_g_r_o_u_p_s reads through the group file and sets up, using
     the _s_e_t_g_r_o_u_p_s(2) call, the group access list for the user
     specified in _n_a_m_e.  The _b_a_s_e_g_i_d is automatically included in
     the groups list.  Typically this value is given as the group
     number from the password file.

FILES
     /etc/group

SEE ALSO
     setgroups(2)

DIAGNOSTICS
     _I_n_i_t_g_r_o_u_p_s returns -1 if it was not invoked by the super-
     user.

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


























Printed 11/26/99	  May 12, 1986				1