Commit | Line | Data |
---|---|---|
59d11f9a KB |
1 | .\" Copyright (c) 1980, 1990, 1993 |
2 | .\" The Regents of the University of California. All rights reserved. | |
3d86f03a | 3 | .\" |
cf136d2c KB |
4 | .\" This code is derived from software contributed to Berkeley by |
5 | .\" the Institute of Electrical and Electronics Engineers, Inc. | |
6 | .\" | |
3d98c418 | 7 | .\" %sccs.include.redist.roff% |
3d86f03a | 8 | .\" |
59d11f9a | 9 | .\" @(#)kill.1 8.1 (Berkeley) %G% |
d9d7a9f0 CL |
10 | .\" |
11 | .Dd | |
12 | .Dt KILL 1 | |
73c88b5b | 13 | .Os |
d9d7a9f0 CL |
14 | .Sh NAME |
15 | .Nm kill | |
16 | .Nd terminate or signal a process | |
17 | .Sh SYNOPSIS | |
18 | .Nm kill | |
19 | .Op Fl signal_name | |
20 | .Ar pid | |
21 | \&... | |
22 | .Nm kill | |
813fa23f KB |
23 | .Op Fl signal_number |
24 | .Ar pid | |
25 | \&... | |
26 | .Nm kill | |
d9d7a9f0 CL |
27 | .Op Fl l |
28 | .Sh DESCRIPTION | |
3d98c418 CL |
29 | The kill utility sends the |
30 | .Dv TERM | |
31 | signal to the processes specified | |
813fa23f KB |
32 | by the pid operand(s). |
33 | .Pp | |
34 | Only the super-user may send signals to other users' processes. | |
5325ced3 | 35 | .Pp |
813fa23f | 36 | The options are as follows: |
5325ced3 | 37 | .Pp |
3d98c418 CL |
38 | .Bl -tag -width Ds |
39 | .It Fl l | |
813fa23f | 40 | List the signal names. |
3d98c418 | 41 | .It Fl signal_name |
813fa23f | 42 | A symbolic signal name specifying the signal to be sent instead of the |
3d98c418 CL |
43 | default |
44 | .Dv TERM . | |
813fa23f KB |
45 | The |
46 | .Fl l | |
47 | option displays the signal names. | |
3d98c418 | 48 | .It Fl signal_number |
813fa23f | 49 | A non-negative decimal integer, specifying the signal to be sent instead |
3d98c418 CL |
50 | of the default |
51 | .Dv TERM . | |
52 | .El | |
d9d7a9f0 | 53 | .Pp |
813fa23f | 54 | Some of the more commonly used signals: |
3d98c418 CL |
55 | .Bd -ragged -offset indent -compact |
56 | .Bl -column XXX TERM | |
54e9e2f8 KB |
57 | .It -1 -1 (super-user broadcast to all processes, or user broadcast |
58 | to user's processes) | |
3d98c418 | 59 | .It 0 0 (sh(1) only, signals all members of process group) |
54e9e2f8 | 60 | .It 2 INT (interrupt) |
3d98c418 CL |
61 | .It 3 QUIT (quit) |
62 | .It 6 ABRT (abort) | |
63 | .It 9 KILL (non-catchable, non-ignorable kill) | |
64 | .It 14 ALRM (alarm clock) | |
65 | .It 15 TERM (software termination signal) | |
66 | .El | |
67 | .Ed | |
d9d7a9f0 CL |
68 | .Pp |
69 | .Nm Kill | |
3d86f03a | 70 | is a built-in to |
d9d7a9f0 | 71 | .Xr csh 1 ; |
9efdb578 | 72 | it allows job specifiers of the form ``%...'' as arguments |
3d86f03a | 73 | so process id's are not as often used as |
d9d7a9f0 | 74 | .Nm kill |
3d86f03a KM |
75 | arguments. |
76 | See | |
d9d7a9f0 | 77 | .Xr csh 1 |
3d86f03a | 78 | for details. |
d9d7a9f0 CL |
79 | .Sh SEE ALSO |
80 | .Xr csh 1 , | |
81 | .Xr ps 1 , | |
82 | .Xr kill 2 , | |
83 | .Xr sigvec 2 | |
84 | .Sh HISTORY | |
85 | A | |
86 | .Nm kill | |
3d98c418 CL |
87 | command appeared in |
88 | .At v6 . | |
d9d7a9f0 | 89 | .Sh BUGS |
3d98c418 | 90 | A replacement for the command |
d9d7a9f0 | 91 | .Dq Li kill 0 |
3d86f03a | 92 | for |
d9d7a9f0 | 93 | .Xr csh 1 |
3d86f03a | 94 | users should be provided. |