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
36 .Op Fl h \&| Ns Fl \&?
45 kills processes selected by name, as opposed to the selection by pid
48 By default, it will send a
50 signal to all processes with an effective UID identical to the
55 The super-user is allowed to kill any process.
57 The options are as follows:
58 .Bl -tag -width 10n -offset indent
60 Be more verbose about what will be done. For a single
62 option, a list of the processes that will be sent the signal will be
63 printed, or a message indicating that no matching processes have been
66 has been specified at least twice, the effective UID, PID, and name
67 of all processes found in
69 will be listed in addition.
70 .It Fl h \&| Ns Fl \&?
72 Give a help on the command usage and exit.
74 List the names of the available signals and exit, like in
79 as a (case insensitive) regular expression against the names
82 CAUTION! This is dangerous, a single dot will match any process
83 running under the effective UID of the caller. The regular expression
84 syntax in effect is that used by
87 Show only what would be done, but do not send any signal.
89 Send a different signal instead of the default
91 The signal may be specified either as a name
92 .Pq with \&or without a leading Dv SIG ,
97 Sending a signal to all processes with uid
99 is already supported by
103 for this job (e.g. $ kill -TERM -1 or
104 as root $ echo kill -TERM -1 | su -m <user>)
110 command will respond with a short usage message and exit with a status
111 of 2 in case of a command error. A status of 1 will be returned if
112 either no matching process has been found or not all processes have
113 been signalled successfully. Otherwise, a status of 0 will be
116 Diagnostic messages will only be printed if requested by
127 It has been modeled after the
129 command as available on other platforms.
131 The program has been contributed by
132 .An Wolfram Schneider ,
133 this manual page has been written by
135 .if t J\(:org Wunsch.