GETGROUPS(2)                                                      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  com‐
       patibility with earlier systems.



4.2 Berkeley Distribution        May 13, 1986                     GETGROUPS(2)