1 .\" Copyright (C) 1995 by Joerg Wunsch, Dresden
2 .\" All rights reserved.
4 .\" Redistribution and use in source and binary forms, with or without
5 .\" modification, are permitted provided that the following conditions
7 .\" 1. Redistributions of source code must retain the above copyright
8 .\" notice, this list of conditions and the following disclaimer.
9 .\" 2. Redistributions in binary form must reproduce the above copyright
10 .\" notice, this list of conditions and the following disclaimer in the
11 .\" documentation and/or other materials provided with the distribution.
13 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR(S) ``AS IS'' AND ANY EXPRESS
14 .\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
15 .\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
16 .\" DISCLAIMED. IN NO EVENT SHALL THE AUTHOR(S) BE LIABLE FOR ANY DIRECT,
17 .\" INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
18 .\" (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
19 .\" SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
20 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
21 .\" STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
22 .\" IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
23 .\" POSSIBILITY OF SUCH DAMAGE.
32 .Nd kill processes by name
47 utility kills processes selected by name, as opposed to the selection by PID
50 By default, it will send a
52 signal to all processes with a real UID identical to the
57 The super-user is allowed to kill any process.
59 The options are as follows:
60 .Bl -tag -width ".Fl c Ar procname"
62 Be more verbose about what will be done, but do not send any signal.
63 The total number of user processes and the real user ID is shown.
64 A list of the processes that will be sent the signal will be printed, or a
65 message indicating that no matching processes have been found.
67 Use the effective user ID instead of the (default) real user ID for matching
68 processes specified with the
72 Give a help on the command usage and exit.
74 Request confirmation before attempting to signal each
77 List the names of the available signals and exit, like in
82 as a (case sensitive) regular expression against the names
85 This is dangerous, a single dot will match any process
86 running under the real UID of the caller.
88 Be verbose about what will be done.
92 but do not send any signal.
94 Send a different signal instead of the default
96 The signal may be specified either as a name
97 (with or without a leading
101 Kill processes in the specified
104 Limit potentially matching processes to those belonging to
108 Limit potentially matching processes to those running on
112 Limit potentially matching processes to those matching
116 Suppress error message if no processes are matched.
119 This should not have any effect except to print a few error messages
120 if there are zombie processes that match the specified pattern.
123 Sending a signal to all processes with the given UID
124 is already supported by
129 .Dq Li "kill -TERM -1"
131 .Dq Li "echo kill -TERM -1 | su -m <user>" ) .
132 .Sh IMPLEMENTATION NOTES
137 has completely different semantics as compared to the traditional
141 The latter will kill all processes that the current user is able to
142 kill, and is intended to be used by the system shutdown process only.
146 utility exits 0 if some processes have been found and
147 signalled successfully.
148 Otherwise, a status of 1 will be
153 to all firefox processes:
154 .Bd -literal -offset indent
160 to firefox processes belonging to
162 .Bd -literal -offset indent
163 killall -u ${USER} firefox
166 Stop all firefox processes:
167 .Bd -literal -offset indent
168 killall -SIGSTOP firefox
171 Resume firefox processes:
172 .Bd -literal -offset indent
173 killall -SIGCONT firefox
176 Show what would be done to firefox processes, but do not actually signal them:
177 .Bd -literal -offset indent
183 to csh process running inside jail ID 282:
184 .Bd -literal -offset indent
190 to all processes matching provided pattern (like vim and vimdiff):
191 .Bd -literal -offset indent
195 Diagnostic messages will only be printed if the
208 It has been modeled after the
210 command as available on other platforms.
215 program was originally written in Perl and was contributed by
216 .An Wolfram Schneider ,
217 this manual page has been written by
219 The current version of
221 was rewritten in C by