4.3BSD-UWisc/man/cat2/getgroups.2

Compare this file to the similar file:
Show the results in this format:



GETGROUPS(2)        UNIX Programmer's Manual         GETGROUPS(2)



NAME
     getgroups - get group access list

SYNOPSIS
     #include <sys/param.h>

     ngroups = getgroups(gidsetlen, gidset)
     int ngroups, gidsetlen, *gidset;

DESCRIPTION
     _G_e_t_g_r_o_u_p_s gets the current group access list of the user
     process and stores it in the array _g_i_d_s_e_t.  The parameter
     _g_i_d_s_e_t_l_e_n indicates the number of entries that may be placed
     in _g_i_d_s_e_t.  _G_e_t_g_r_o_u_p_s returns the actual number of groups
     returned in _g_i_d_s_e_t.  No more than NGROUPS, as defined in
     <_s_y_s/_p_a_r_a_m._h>, will ever be returned.

RETURN VALUE
     A successful call returns the number of groups in the group
     set.  A value of -1 indicates that an error occurred, and
     the error code is stored in the global variable _e_r_r_n_o.

ERRORS
     The possible errors for _g_e_t_g_r_o_u_p are:

     [EINVAL]       The argument _g_i_d_s_e_t_l_e_n is smaller than the
                    number of groups in the group set.

     [EFAULT]       The argument _g_i_d_s_e_t specifies an invalid
                    address.

SEE ALSO
     setgroups(2), initgroups(3X)

BUGS
     The _g_i_d_s_e_t array should be of type gid_t, but remains
     integer for compatibility with earlier systems.


















Printed 12/27/86          May 13, 1986                          1