GETGROUPS(2) 1990 GETGROUPS(2) NNAAMMEE getgroups - get group access list SSYYNNOOPPSSIISS ##iinncclluuddee <<ssyyss//ppaarraamm..hh>> nnggrroouuppss == ggeettggrroouuppss((ggiiddsseettlleenn,, ggiiddsseett)) iinntt nnggrroouuppss,, ggiiddsseettlleenn,, **ggiiddsseett;; DDEESSCCRRIIPPTTIIOONN _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. RREETTUURRNN VVAALLUUEE 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. EERRRROORRSS 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. SSEEEE AALLSSOO setgroups(2), initgroups(3) BBUUGGSS The _g_i_d_s_e_t array should be of type ggiidd__tt, but remains integer for compatibility with earlier systems. Printed 7/27/90 June 1