home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 4 / FreshFish_May-June1994.bin / bbs / gnu / ixemul-39.47-env-bin.lha / man / cat2 / getgroups.0 < prev    next >
Encoding:
Text File  |  1993-12-07  |  1.8 KB  |  67 lines
  1.  
  2. GETGROUPS(2)               UNIX Programmer's Manual               GETGROUPS(2)
  3.  
  4. NNAAMMEE
  5.      ggeettggrroouuppss - get group access list
  6.  
  7. SSYYNNOOPPSSIISS
  8.      ##iinncclluuddee <<ssyyss//ppaarraamm..hh>>
  9.      ##iinncclluuddee <<uunniissttdd..hh>>
  10.  
  11.      _i_n_t
  12.      ggeettggrroouuppss(_i_n_t _g_i_d_s_e_t_l_e_n, _i_n_t _*_g_i_d_s_e_t)
  13.  
  14. DDEESSCCRRIIPPTTIIOONN
  15.      GGeettggrroouuppss() gets the current group access list of the user process and
  16.      stores it in the array _g_i_d_s_e_t. The parameter _g_i_d_s_e_t_l_e_n indicates the num­
  17.      ber of entries that may be placed in _g_i_d_s_e_t. GGeettggrroouuppss() returns the ac­
  18.      tual number of groups returned in _g_i_d_s_e_t. No more than NGROUPS, as de­
  19.      fined in <_s_y_s_/_p_a_r_a_m_._h>, will ever be returned.
  20.  
  21. RREETTUURRNN VVAALLUUEESS
  22.      A successful call returns the number of groups in the group set.  A value
  23.      of ­1 indicates that an error occurred, and the error code is stored in
  24.      the global variable _e_r_r_n_o.
  25.  
  26. EERRRROORRSS
  27.      The possible errors for ggeettggrroouuppss() are:
  28.  
  29.      [EINVAL]      The argument _g_i_d_s_e_t_l_e_n is smaller than the number of groups
  30.                    in the group set.
  31.  
  32.      [EFAULT]      The argument _g_i_d_s_e_t specifies an invalid address.
  33.  
  34. SSEEEE AALLSSOO
  35.      setgroups(2),  initgroups(3)
  36.  
  37. BBUUGGSS
  38.      The _g_i_d_s_e_t array should be of type _g_i_d___t _,
  39.      but remains integer for compatibility with earlier systems.
  40.  
  41. HHIISSTTOORRYY
  42.      The ggeettggrroouuppss 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.