doc/killall.1

   1 .TH KILLALL 1 2007-08-09 "Linux" "User Commands"
   2 .SH NAME
   3 killall \- kill processes by name
   4 .SH SYNOPSIS
   5 .ad l
   6 .B killall
   7 .RB [ \-Z , \-\-context
   8 .IR pattern ]
   9 .RB [ \-e , \-\-exact ]
  10 .RB [ \-g , \-\-process\-group ]
  11 .RB [ \-i , \-\-interactive ]
  12 .RB [ \-q , \-\-quiet ]
  13 .RB [ \-r , \-\-regexp ]
  14 .RB [ \-s , \-\-signal
  15 .IR signal ]
  16 .RB [ \-u , \-\-user
  17 .IR user ]
  18 .RB [ \-v , \-\-verbose ]
  19 .RB [ \-w , \-\-wait ]
  20 .RB [ \-I , \-\-ignore-case ]
  21 .RB [ \-V, \-\-version ]
  22 .RB [ \-\- ]
  23 .I name ...
  24 .br
  25 .B killall
  26 .RB \-l
  27 .br
  28 .B killall
  29 .RB \-V, \-\-version
  30 .ad b
  31 .SH DESCRIPTION
  32 .B killall
  33 sends a signal to all processes running any of the specified commands. If no
  34 signal name is specified, SIGTERM is sent.
  35 .PP
  36 Signals can be specified either by name (e.g. \fB\-HUP\fP or \fB-SIGHUP\fP )
  37 or by number (e.g. \fB\-1\fP) or by option \fB-s\fP.
  38 .PP
  39 If the command name is not regular expression (option \fB-r\fP)
  40 and contains a slash (\fB/\fP), processes executing that
  41 particular file will be selected for killing, independent of their name.
  42 .PP
  43 \fBkillall\fP returns a zero return code if at least one process has been
  44 killed for each listed command, or no commands were listed and at least
  45 one process matched the -u and -Z search criteria. \fBkillall\fP returns
  46 non-zero otherwise.
  47 .PP
  48 A \fBkillall\fP process never kills itself (but may kill other \fBkillall\fP
  49 processes).
  50 .SH OPTIONS
  51 .IP "\fB\-e\fP, \fB\-\-exact\fP"
  52 Require an exact match for very long names. If a command name is longer
  53 than 15 characters, the full name may be unavailable (i.e. it is swapped
  54 out). In this case, \fBkillall\fP will kill everything that matches within
  55 the first 15 characters. With \fB\-e\fP, such entries are skipped.
  56 \fBkillall\fP prints a message for each skipped entry
  57 if \fB\-v\fP is specified in addition to \fB\-e\fP,
  58 .IP "\fB\-I\fP, \fB\-\-ignore\-case\fP"
  59 Do case insensitive process name match.
  60 .IP "\fB\-g\fP, \fB\-\-process\-group\fP"
  61 Kill the process group to which the process belongs. The kill signal is only
  62 sent once per group, even if multiple processes belonging to the same process
  63 group were found.
  64 .IP "\fB\-i\fP, \fB\-\-interactive\fP"
  65 Interactively ask for confirmation before killing.
  66 .IP "\fB\-l\fP, \fB\-\-list\fP"
  67 List all known signal names.
  68 .IP "\fB\-q\fP, \fB\-\-quiet\fP"
  69 Do not complain if no processes were killed.
  70 .IP "\fB\-r\fP, \fB\-\-regexp\fP"
  71 Interpret process name pattern as an extended regular expression.
  72 .IP "\fB\-s\fP, \fB\-\-signal\fP"
  73 Send this signal instead of SIGTERM.
  74 .IP "\fB\-u\fP, \fB\-\-user\fP"
  75 Kill only processes the specified user owns. Command names are optional.
  76 .IP "\fB\-v\fP, \fB\-\-verbose\fP"
  77 Report if the signal was successfully sent.
  78 .IP "\fB\-V\fP, \fB\-\-version\fP"
  79 Display version information.
  80 .IP "\fB\-w\fP, \fB\-\-wait\fP"
  81 Wait for all killed processes to die. \fBkillall\fP checks once per second if
  82 any of the killed processes still exist and only returns if none are left.
  83 Note that \fBkillall\fP may wait forever if the signal was ignored, had no
  84 effect, or if the process stays in zombie state.
  85 .IP "\fB\-Z\fP, \fB\-\-context\fP"
  86 (SELinux Only) Specify security context: kill only processes having security
  87 context that match with given expended regular expression pattern. Must precede
  88 other arguments on the command line. Command names are optional.
  89 .SH FILES
  90 .nf
  91 /proc   location of the proc file system
  92 .fi
  93 .SH "KNOWN BUGS"
  94 Killing by file only works for executables that are kept open during
  95 execution, i.e. impure executables can't be killed this way.
  96 .PP
  97 Be warned that typing \fBkillall\fP \fIname\fP may not have the desired
  98 effect on non-Linux systems, especially when done by a privileged
  99 user.
 100 .PP
 101 \fBkillall \-w\fP doesn't detect if a process disappears and is replaced by
 102 a new process with the same PID between scans.
 103 .PP
 104 If processes change their name, \fBkillall\fP may not be able to match
 105 them correctly.
 106 .SH AUTHORS
 107 Werner Almesberger <werner@almesberger.net> wrote the original version
 108 of psmisc. Since version 20 Craig Small <csmall@small.dropbear.id.au>
 109 can be blamed.
 110 .SH "SEE ALSO"
 111 .BR kill "(1), " fuser "(1), " pgrep "(1), " pidof "(1), " pkill "(1), "
 112 .BR ps "(1), " kill (2).
 113 .\"{{{}}}