usr.bin/killall/killall.1

   1 .\" Copyright (C) 1995 by Joerg Wunsch, Dresden
   2 .\" All rights reserved.
   3 .\"
   4 .\" Redistribution and use in source and binary forms, with or without
   5 .\" modification, are permitted provided that the following conditions
   6 .\" are met:
   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.
  12 .\"
  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.
  24 .\"
  25 .\" $FreeBSD: src/usr.bin/killall/killall.1,v 1.11.2.11 2003/02/25 20:31:18 trhodes Exp $
  26 .\" $DragonFly: src/usr.bin/killall/killall.1,v 1.2 2003/06/17 04:29:27 dillon Exp $
  27 .\"
  28 .Dd June 25, 1995
  29 .Os
  30 .Dt KILLALL 1
  31 .Sh NAME
  32 .Nm killall
  33 .Nd kill processes by name
  34 .Sh SYNOPSIS
  35 .Nm
  36 .Op Fl d | v
  37 .Op Fl h | ?\&
  38 .Op Fl help
  39 .Op Fl l
  40 .Op Fl m
  41 .Op Fl s
  42 .Op Fl u Ar user
  43 .Op Fl t Ar tty
  44 .Op Fl c Ar procname
  45 .Op Fl SIGNAL
  46 .Op Ar procname ...
  47 .Sh DESCRIPTION
  48 The
  49 .Nm
  50 utility kills processes selected by name, as opposed to the selection by pid
  51 as done by
  52 .Xr kill 1 .
  53 By default, it will send a
  54 .Dv TERM
  55 signal to all processes with a real UID identical to the
  56 caller of
  57 .Nm
  58 that match the name
  59 .Ar procname .
  60 The super-user is allowed to kill any process.
  61 .Pp
  62 The options are as follows:
  63 .Bl -tag -width 10n -offset indent
  64 .It Fl d | v
  65 Be more verbose about what will be done.  For a single
  66 .Fl d
  67 option, a list of the processes that will be sent the signal will be
  68 printed, or a message indicating that no matching processes have been
  69 found.
  70 .It Fl h | ?\&
  71 .It Fl help
  72 Give a help on the command usage and exit.
  73 .It Fl l
  74 List the names of the available signals and exit, like in
  75 .Xr kill 1 .
  76 .It Fl m
  77 Match the argument
  78 .Ar procname
  79 as a (case insensitive) regular expression against the names
  80 of processes found.
  81 CAUTION!  This is dangerous, a single dot will match any process
  82 running under the real UID of the caller.
  83 .It Fl s
  84 Show only what would be done, but do not send any signal.
  85 .It Fl SIGNAL
  86 Send a different signal instead of the default
  87 .Dv TERM .
  88 The signal may be specified either as a name
  89 (with or without a leading
  90 .Dv SIG ) ,
  91 or numerically.
  92 .It Fl u Ar user
  93 Limit potentially matching processes to those belonging to
  94 the specified
  95 .Ar user .
  96 .It Fl t Ar tty
  97 Limit potentially matching processes to those running on
  98 the specified
  99 .Ar tty .
 100 .It Fl c Ar procname
 101 When used with the
 102 .Fl u
 103 or
 104 .Fl t
 105 flags, limit potentially matching processes to those matching
 106 the specified
 107 .Ar procname .
 108 .El
 109 .Sh ALL PROCESSES
 110 Sending a signal to all processes with uid
 111 .Em XYZ
 112 is already supported by
 113 .Xr kill 1 .
 114 So use
 115 .Xr kill 1
 116 for this job (e.g. $ kill -TERM -1 or
 117 as root $ echo kill -TERM -1 | su -m <user>)
 118 .Sh DIAGNOSTICS
 119 The
 120 .Nm
 121 command will respond with a short usage message and exit with a status
 122 of 2 in case of a command error.  A status of 1 will be returned if
 123 either no matching process has been found or not all processes have
 124 been signalled successfully.  Otherwise, a status of 0 will be
 125 returned.
 126 .Pp
 127 Diagnostic messages will only be printed if requested by
 128 .Fl d
 129 options.
 130 .Sh SEE ALSO
 131 .Xr kill 1 ,
 132 .Xr sysctl 3
 133 .Sh HISTORY
 134 The
 135 .Nm
 136 command appeared in
 137 .Fx 2.1 .
 138 It has been modeled after the
 139 .Nm
 140 command as available on other platforms.
 141 .Sh AUTHORS
 142 .An -nosplit
 143 The
 144 .Nm
 145 program was originally written in Perl and was contributed by
 146 .An Wolfram Schneider ,
 147 this manual page has been written by
 148 .An J\(:org Wunsch .
 149 The current version of
 150 .Nm
 151 was rewritten in C by
 152 .An Peter Wemm
 153 using
 154 .Xr sysctl 3 .