home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / prgtools / mint / mntdoc01.zoo / mintdoc / cat3 / kill.3 < prev    next >
Encoding:
Text File  |  1993-03-03  |  2.0 KB  |  67 lines
  1.  
  2.  
  3.  
  4. KILL(3)             MINTLIB LIBRARY FUNCTIONS             KILL(3)
  5.  
  6.  
  7. N✓NA✓AM✓ME✓E
  8.        kill - send a signal to a process or a group of processes
  9.  
  10. S✓SY✓YN✓NO✓OP✓PS✓SI✓IS✓S
  11.        #include <unistd.h>
  12.  
  13.        int kill(int pid, int sig);
  14.  
  15. D✓DE✓ES✓SC✓CR✓RI✓IP✓PT✓TI✓IO✓ON✓N
  16.        kill  sends a signal to a process or a group of processes.
  17.        The process of group of processes to which the  signal  is
  18.        to  be  sent is specified by pid. The signal that is to be
  19.        sent is specified by sig and is either on  from  the  list
  20.        given  in  signal,  or  0.  If sig is 0 (the null signal),
  21.        error checking is performed  but  no  signal  is  actually
  22.        sent. This can be used to check the validity of pid.
  23.  
  24.        The  real  user  ID  of the sending process must match the
  25.        real user ID of the receiving process, unless  the  effec-
  26.        tive user ID of the sending process is super-user.
  27.  
  28.        If  pid is greater than zero, sig will be sent to the pro-
  29.        cess whose process ID is equal to pid.
  30.  
  31.        If pid is 0, sig will be sent to all processes whose  pro-
  32.        cess  group  ID  is  equal  to the process group ID of the
  33.        sender.
  34.  
  35.        If pid is negative, sig will  be  sent  to  all  processes
  36.        whose  process  group ID is equal to the absolute value of
  37.        pid.
  38.  
  39. R✓RE✓ET✓TU✓UR✓RN✓N V✓VA✓AL✓LU✓UE✓ES✓S
  40.         0 on success -1 on failure; errno is set to indicate  the
  41.        error
  42.  
  43. S✓SE✓EE✓E A✓AL✓LS✓SO✓O
  44.        g✓ge✓et✓tp✓pi✓id✓d(✓(3✓3)✓),✓, g✓ge✓et✓tp✓pg✓gr✓rp✓p(✓(3✓3)✓),✓, s✓se✓et✓tp✓pr✓rg✓gp✓p(✓(3✓3)✓),✓, s✓si✓ig✓gn✓na✓al✓l(✓(3✓3)✓),✓, P✓Pk✓ki✓il✓ll✓l(✓(2✓2)✓)
  45.  
  46. N✓NO✓OT✓TE✓ES✓S
  47.        Under  UN*X,  the real or effective user ID of the sending
  48.        process must match the real or effective user  ID  of  the
  49.        receiving process, or the effective user ID of the sending
  50.        process must be super-user.
  51.  
  52.        Under UN*X, the processes with a process ID  of  0  and  a
  53.        process ID of 1 are treated specially.
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64. MiNT docs 0.1              3 March 1993                         1
  65.  
  66.  
  67.