projects / unix-history / blame
| Commit | Line | Data |
|---|---|---|
| d9d7a9f0 CL |
1 | .\" Copyright (c) 1980, 1990 The Regents of the University of California. |
| 2 | .\" All rights reserved. | |
| 3d86f03a | 3 | .\" |
| d9d7a9f0 | 4 | .\" %sccs.include.redist.man% |
| 3d86f03a | 5 | .\" |
| d0719240 | 6 | .\" @(#)kill.1 6.5 (Berkeley) %G% |
| d9d7a9f0 CL |
7 | .\" |
| 8 | .Dd | |
| 9 | .Dt KILL 1 | |
| 10 | .Os BSD 4.4 | |
| 11 | .Sh NAME | |
| 12 | .Nm kill | |
| 13 | .Nd terminate or signal a process | |
| 14 | .Sh SYNOPSIS | |
| 15 | .Nm kill | |
| 16 | .Op Fl signal_name | |
| 17 | .Ar pid | |
| 18 | \&... | |
| 19 | .Nm kill | |
| 20 | .Op Fl l | |
| 21 | .Sh DESCRIPTION | |
| 22 | The kill utility sends a signal to the process(es) specified | |
| 23 | by each pid operand. It is used to kill runaway or misbegotten | |
| 24 | processes, such as those | |
| 25 | .Em backgrounded | |
| 26 | with | |
| 27 | .Sq Li \&& . | |
| 28 | .Nm Kill | |
| 29 | is intelligent about who owns a process. | |
| 5325ced3 CL |
30 | .Pp |
| 31 | Options available: | |
| 32 | .Pp | |
| d9d7a9f0 CL |
33 | .Tw Ds |
| 34 | .Tp Fl signal_name | |
| 35 | A symbolic signal name. To find out all the possible signal names | |
| 36 | do a | |
| 37 | .Li kill -l . | |
| 38 | .Tp Fl l | |
| 39 | Available signal names are listed and are as found in | |
| 40 | .Pa /usr/include/signal.h , | |
| 3d86f03a | 41 | stripped of the common SIG prefix. |
| d9d7a9f0 CL |
42 | .Tp Fl signal_number |
| 43 | A (nonnegative) decimal integer, representing the signal | |
| 44 | to be used instead of TERM as the sig argument in | |
| 45 | the effective call to | |
| 5325ced3 | 46 | .Xr kill 2 . |
| d9d7a9f0 CL |
47 | .Tp |
| 48 | .Pp | |
| 49 | Some of the more commonly used signals with kill: | |
| 50 | .Ds I | |
| 51 | .Cw XXX TERM | |
| 52 | .Cl -1 -1 (broadcast to all processes, super user only) | |
| 53 | .Cl 0 0 (sh(1) only, signals all members of process group) | |
| 54 | .Cl 2 INT (interupt) | |
| 55 | .Cl 3 QUIT (quit) | |
| 56 | .Cl 6 ABRT (abort) | |
| 57 | .Cl 9 KILL (non-catchable non-ignorable kill) | |
| 58 | .Cl 14 ALRM (alarm clock) | |
| 59 | .Cl 15 TERM (software termination signal) | |
| 60 | .Cw | |
| 61 | .De | |
| 62 | .Pp | |
| 63 | .Nm Kill | |
| 3d86f03a | 64 | is a built-in to |
| d9d7a9f0 | 65 | .Xr csh 1 ; |
| 9efdb578 | 66 | it allows job specifiers of the form ``%...'' as arguments |
| 3d86f03a | 67 | so process id's are not as often used as |
| d9d7a9f0 | 68 | .Nm kill |
| 3d86f03a KM |
69 | arguments. |
| 70 | See | |
| d9d7a9f0 | 71 | .Xr csh 1 |
| 3d86f03a | 72 | for details. |
| d9d7a9f0 CL |
73 | .Sh SEE ALSO |
| 74 | .Xr csh 1 , | |
| 75 | .Xr ps 1 , | |
| 76 | .Xr kill 2 , | |
| 77 | .Xr sigvec 2 | |
| 78 | .Sh HISTORY | |
| 79 | A | |
| 80 | .Nm kill | |
| 81 | command appeared in Version 6 AT&T Unix. | |
| 82 | .Sh BUGS | |
| 83 | A replacement for | |
| 84 | .Dq Li kill 0 | |
| 3d86f03a | 85 | for |
| d9d7a9f0 | 86 | .Xr csh 1 |
| 3d86f03a | 87 | users should be provided. |