home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 8 / FreshFishVol8-CD1.bin / gnu / man / cat2 / setpgid.0 < prev    next >
Text File  |  1993-12-07  |  2KB  |  67 lines
  1.  
  2. SETPGRP(2)                 UNIX Programmer's Manual                 SETPGRP(2)
  3.  
  4. NNAAMMEE
  5.      sseettppggiidd, sseettppggrrpp - set process group
  6.  
  7. SSYYNNOOPPSSIISS
  8.      ##iinncclluuddee <<uunniissttdd..hh>>
  9.  
  10.      _i_n_t
  11.      sseettppggiidd(_p_i_d___t_p_i_d, _p_i_d___t_p_g_r_p)
  12.  
  13.      _i_n_t
  14.      sseettppggrrpp(_p_i_d___t_p_i_d, _p_i_d___t_p_g_r_p)
  15.  
  16. DDEESSCCRRIIPPTTIIOONN
  17.      SSeettppggiidd() sets the process group of the specified process _p_i_d to the
  18.      specified _p_g_r_p. If _p_i_d is zero, then the call applies to the current pro­
  19.      cess.
  20.  
  21.      If the invoker is not the super­user, then the affected process must have
  22.      the same effective user­id as the invoker or be a descendant of the in­
  23.      voking process.
  24.  
  25. RREETTUURRNN VVAALLUUEESS
  26.      SSeettppggiidd() returns 0 when the operation was successful.  If the request
  27.      failed, ­1 is returned and the global variable _e_r_r_n_o indicates the rea­
  28.      son.
  29.  
  30. EERRRROORRSS
  31.      SSeettppggiidd() will fail and the process group will not be altered if:
  32.  
  33.      [ESRCH]
  34.              The requested process does not exist.
  35.  
  36.      [EPERM]
  37.              The effective user ID of the requested process is different from
  38.              that of the caller and the process is not a descendent of the
  39.              calling process.
  40.  
  41. SSEEEE AALLSSOO
  42.      getpgrp(2)
  43.  
  44. SSTTAANNDDAARRDDSS
  45.      SSeettppggiidd() conforms to IEEE Std 1003.1­1988 (``POSIX'').
  46.  
  47. CCOOMMPPAATTIIBBIILLIITTYY
  48.      SSeettppggrrpp() is identical to sseettppggiidd(), and is retained for calling conven­
  49.      tion compatibility with historical versions of BSD UNIX.
  50.  
  51. 4th Berkeley Distribution       March 10, 1991                               1
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.