File: killall.1

package info (click to toggle)
psmisc 17-1
  • links: PTS
  • area: main
  • in suites: slink
  • size: 148 kB
  • ctags: 179
  • sloc: ansic: 1,540; makefile: 82; sh: 6
file content (76 lines) | stat: -rw-r--r-- 2,578 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
.TH KILLALL 1 "February 17, 1998" "Linux" "User Commands"
.SH NAME
killall \- kill processes by name
.SH SYNOPSIS
.ad l
.B killall
.RB [ \-eiqvw ]
.RB [ \-\fIsignal\fB ]
.I name ...
.br
.B killall
.RB \-l
.br
.B killall
.RB \-V
.ad b
.SH DESCRIPTION
.B killall
sends a signal to all processes running any of the specified commands. If no
signal name is specified, SIGTERM is sent.
.PP
Signals can be specified either by name (e.g. \fB\-HUP\fP) or by number
(e.g. \fB\-1\fP). Signal 0 (check if a process exists) can only be specified
by number.
.PP
If the command name contains a slash (\fB/\fP), processes executing that
particular file will be selected for killing, independent of their name.
.PP
\fBkillall\fP returns a non-zero return code if no process has been killed
for any of the listed commands. If at least one process has been killed for
each command, \fBkillall\fP returns zero.
.PP
A \fBkillall\fP process never kills itself (but may kill other \fBkillall\fP
processes).
.SH OPTIONS
.IP \fB\-e\fP
Require an exact match for very long names. If a command name is longer
than 15 characters, the full name may be unavailable (i.e. it is swapped
out). In this case, \fBkillall\fP will kill everything that matches within
the first 15 characters. With \fB\-e\fP, such entries are skipped.
\fBkillall\fP prints a message for each skipped entry 
if \fB\-v\fP is specified in addition to \fB\-e\fP,
.IP \fB\-i\fP
Interactively ask for confirmation before killing.
.IP \fB\-l\fP
List all known signal names.
.IP \fB\-q\fP
Do not complain of no processes were killed.
.IP \fB\-v\fP
Report if the signal was successfully sent.
.IP \fB\-V\fP
Display version information.
.IP \fB\-w\fP
Wait for all killed processes to die. \fBkillall\fP checks once per second if
any of the killed processes still exist and only returns if none are left.
Note that \fBkillall\fP may wait forever if the signal was ignored, had no
effect, or if the process stays in zombie state.
.SH FILES
.nf
/proc	location of the proc file system
.fi
.SH "KNOWN BUGS"
Killing by file only works for executables that are kept open during
execution, i.e. impure executables can't be killed this way.
.PP
Be warned that typing \fBkillall\fP \fIname\fP may not have the desired
effect on non-Linux systems, especially when done by a privileged
user.
.PP
\fBkillall \-w\fP doesn't detect if a process disappears and is replaced by
a new process with the same PID between scans.
.SH AUTHOR
Werner Almesberger <werner.almesberger@lrc.di.epfl.ch>
.SH "SEE ALSO"
kill(1), fuser(1), pidof(1), ps(1), kill(2)
.\"{{{}}}