kill.1 2.28 KB
Newer Older
albert's avatar
albert committed
1
'\" t
csmall's avatar
csmall committed
2 3 4 5 6 7
.\" (The preceding line is a note to broken versions of man to tell
.\" them to pre-process this man page with tbl)
.\" Man page for kill.
.\" Licensed under version 2 of the GNU General Public License.
.\" Written by Albert Cahalan; converted to a man page by
.\" Michael K. Johnson
8
.TH KILL 1 "October 2011" "procps-ng" "User Commands"
csmall's avatar
csmall committed
9
.SH NAME
albert's avatar
albert committed
10
kill \- send a signal to a process
csmall's avatar
csmall committed
11
.SH SYNOPSIS
12 13
.B kill
[options] <pid> [...]
csmall's avatar
csmall committed
14
.SH DESCRIPTION
15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37
The default signal for kill is TERM.  Use
.B \-l
or
.B \-L
to list available signals.  Particularly useful signals include HUP,
INT, KILL, STOP, CONT, and 0.  Alternate signals may be specified in
three ways:
.BR \-9 ", " \-SIGKILL
or
.BR \-KILL .
Negative PID values may be used to choose whole process groups; see
the PGID column in ps command output.  A PID of
.B \-1
is special; it indicates all processes except the kill process itself
and init.
.SH OPTIONS
.TP
.B <pid> [...]
Send signal to every <pid> listed.
.TP
.B \-<signal>
.TQ
.B \-s <signal>
38 39
.TQ
.B \-\-signal <signal>
40 41 42
Specify the
.B signal
to be sent.  The signal can be specified by using name or number.
43 44 45
The behavior of signals is explained in
.BR signal (7)
manual page.
46
.TP
47 48 49
\fB\-l\fR, \fB\-\-list\fR [\fIsignal\fR]
List signal names.  This option has optional argument, which
will convert signal number to signal name, or other way round.
50
.TP
51
.BR \-L , \ \-\-table
52 53 54
List signal names in a nice table.
.TP
.PD
csmall's avatar
csmall committed
55
.SH NOTES
56 57 58
Your shell (command line interpreter) may have a built-in kill
command.  You may need to run the command described here as /bin/kill
to solve the conflict.
csmall's avatar
csmall committed
59
.SH EXAMPLES
Jan Görig's avatar
Jan Görig committed
60 61
.TP
.B kill \-9 \-1
62
Kill all processes you can kill.
Jan Görig's avatar
Jan Görig committed
63 64
.TP
.B kill \-l 11
65
Translate number 11 into a signal name.
Jan Görig's avatar
Jan Görig committed
66 67
.TP
.B kill -L
68
List the available signal choices in a nice table.
Jan Görig's avatar
Jan Görig committed
69 70
.TP
.B kill 123 543 2341 3453
71
Send the default signal, SIGTERM, to all those processes.
csmall's avatar
csmall committed
72
.SH "SEE ALSO"
Jan Görig's avatar
Jan Görig committed
73
.BR kill (2),
74
.BR killall (1),
Jan Görig's avatar
Jan Görig committed
75
.BR nice (1),
76 77
.BR pkill (1),
.BR renice (1),
Jan Görig's avatar
Jan Görig committed
78
.BR signal (7),
79
.BR skill (1)
csmall's avatar
csmall committed
80
.SH STANDARDS
81 82 83
This command meets appropriate standards. The
.B \-L
flag is Linux-specific.
csmall's avatar
csmall committed
84
.SH AUTHOR
85
.UR albert@users.sf.net
86 87 88 89 90 91
Albert Cahalan
.UE
wrote kill in 1999 to replace a bsdutils one that was not standards
compliant.  The util-linux one might also work correctly.
.SH "REPORTING BUGS"
Please send bug reports to
92
.UR procps@freelists.org
93
.UE