4.3BSD-Reno/share/man/cat2/setgroups.0

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



SETGROUPS(2)		      1990		     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/27/90               June				1