SETGROUPS(2) UNIX Programmer's Manual SETGROUPS(2) NNAAMMEE setgroups - set group access list SSYYNNOOPPSSIISS ##iinncclluuddee <<ssyyss//ppaarraamm..hh>> sseettggrroouuppss((nnggrroouuppss,, ggiiddsseett)) iinntt nnggrroouuppss,, **ggiiddsseett;; DDEESSCCRRIIPPTTIIOONN _S_e_t_g_r_o_u_p_s sets the group access list of the current user process according to the array _g_i_d_s_e_t. The parameter _n_g_r_o_u_p_s indicates the number of entries in the array and must be no more than NGROUPS, as defined in <_s_y_s/_p_a_r_a_m._h>. Only the super-user may set new groups. RREETTUURRNN VVAALLUUEE A 0 value is returned on success, -1 on error, with a error code stored in _e_r_r_n_o. EERRRROORRSS The _s_e_t_g_r_o_u_p_s call will fail if: [EPERM] The caller is not the super-user. [EFAULT] The address specified for _g_i_d_s_e_t is outside the process address space. SSEEEE AALLSSOO getgroups(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/9/88 April 10, 1987 1