home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 4 / FreshFish_May-June1994.bin / gnu / man / cat2 / setgroups.0 < prev    next >
Text File  |  1993-12-07  |  2KB  |  67 lines
  1.  
  2. SETGROUPS(2)               UNIX Programmer's Manual               SETGROUPS(2)
  3.  
  4. NNAAMMEE
  5.      sseettggrroouuppss - set group access list
  6.  
  7. SSYYNNOOPPSSIISS
  8.      ##iinncclluuddee <<uunniissttdd..hh>>
  9.      ##iinncclluuddee <<ssyyss//ppaarraamm..hh>>
  10.  
  11.      _i_n_t
  12.      sseettggrroouuppss(_i_n_t _n_g_r_o_u_p_s, _c_o_n_s_t _i_n_t _*_g_i_d_s_e_t)
  13.  
  14. DDEESSCCRRIIPPTTIIOONN
  15.      SSeettggrroouuppss() sets the group access list of the current user process ac­
  16.      cording to the array _g_i_d_s_e_t. The parameter _n_g_r_o_u_p_s indicates the number
  17.      of entries in the array and must be no more than NGROUPS, as defined in
  18.      <_s_y_s_/_p_a_r_a_m_._h>.
  19.  
  20.      Only the super­user may set new groups.
  21.  
  22. RREETTUURRNN VVAALLUUEESS
  23.      A 0 value is returned on success, ­1 on error, with an error code stored
  24.      in _e_r_r_n_o.
  25.  
  26. EERRRROORRSS
  27.      The sseettggrroouuppss() call will fail if:
  28.  
  29.      [EPERM]       The caller is not the super­user.
  30.  
  31.      [EFAULT]      The address specified for _g_i_d_s_e_t is outside the process ad­
  32.                    dress space.
  33.  
  34. SSEEEE AALLSSOO
  35.      getgroups(2),  initgroups(3)
  36.  
  37. BBUUGGSS
  38.      The _g_i_d_s_e_t array should be of type _g_i_d___t, but remains integer for compat­
  39.      ibility with earlier systems.
  40.  
  41. HHIISSTTOORRYY
  42.      The sseettggrroouuppss function call appeared in 4.2BSD.
  43.  
  44. 4.2 Berkeley Distribution       March 10, 1991                               1
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.