bin/kill/kill.1

   1 .\"-
   2 .\" Copyright (c) 1980, 1990, 1993
   3 .\"     The Regents of the University of California.  All rights reserved.
   4 .\"
   5 .\" This code is derived from software contributed to Berkeley by
   6 .\" the Institute of Electrical and Electronics Engineers, Inc.
   7 .\"
   8 .\" Redistribution and use in source and binary forms, with or without
   9 .\" modification, are permitted provided that the following conditions
  10 .\" are met:
  11 .\" 1. Redistributions of source code must retain the above copyright
  12 .\"    notice, this list of conditions and the following disclaimer.
  13 .\" 2. Redistributions in binary form must reproduce the above copyright
  14 .\"    notice, this list of conditions and the following disclaimer in the
  15 .\"    documentation and/or other materials provided with the distribution.
  16 .\" 3. Neither the name of the University nor the names of its contributors
  17 .\"    may be used to endorse or promote products derived from this software
  18 .\"    without specific prior written permission.
  19 .\"
  20 .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
  21 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  22 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  23 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
  24 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  25 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  26 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  27 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  28 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  29 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  30 .\" SUCH DAMAGE.
  31 .\"
  32 .\"     @(#)kill.1      8.2 (Berkeley) 4/28/95
  33 .\" $FreeBSD: src/bin/kill/kill.1,v 1.22 2010/12/21 22:47:34 jilles Exp $
  34 .\"
  35 .Dd April 28, 1995
  36 .Dt KILL 1
  37 .Os
  38 .Sh NAME
  39 .Nm kill
  40 .Nd terminate or signal a process
  41 .Sh SYNOPSIS
  42 .Nm
  43 .Op Fl s Ar signal_name
  44 .Ar pid ...
  45 .Nm
  46 .Fl l
  47 .Op Ar exit_status
  48 .Nm
  49 .Fl Ar signal_name
  50 .Ar pid ...
  51 .Nm
  52 .Fl Ar signal_number
  53 .Ar pid ...
  54 .Sh DESCRIPTION
  55 The
  56 .Nm
  57 utility sends a signal to the processes specified by the
  58 .Ar pid
  59 operands.
  60 .Pp
  61 Only the super-user may send signals to other users' processes.
  62 .Pp
  63 The options are as follows:
  64 .Bl -tag -width indent
  65 .It Fl s Ar signal_name
  66 A symbolic signal name specifying the signal to be sent instead of the
  67 default
  68 .Dv TERM .
  69 .It Fl l Op Ar exit_status
  70 If no operand is given, list the signal names; otherwise, write
  71 the signal name corresponding to
  72 .Ar exit_status .
  73 .It Fl Ar signal_name
  74 A symbolic signal name specifying the signal to be sent instead of the
  75 default
  76 .Dv TERM .
  77 .It Fl Ar signal_number
  78 A non-negative decimal integer, specifying the signal to be sent instead
  79 of the default
  80 .Dv TERM .
  81 .El
  82 .Pp
  83 The following PIDs have special meanings:
  84 .Bl -tag -width indent
  85 .It -1
  86 If superuser, broadcast the signal to all processes; otherwise broadcast
  87 to all processes belonging to the user.
  88 .El
  89 .Pp
  90 Some of the more commonly used signals:
  91 .Pp
  92 .Bl -tag -width indent -compact
  93 .It 1
  94 HUP (hang up)
  95 .It 2
  96 INT (interrupt)
  97 .It 3
  98 QUIT (quit)
  99 .It 6
 100 ABRT (abort)
 101 .It 9
 102 KILL (non-catchable, non-ignorable kill)
 103 .It 14
 104 ALRM (alarm clock)
 105 .It 15
 106 TERM (software termination signal)
 107 .El
 108 .Pp
 109 Some shells may provide a builtin
 110 .Nm
 111 command which is similar or identical to this utility.
 112 Consult the
 113 .Xr builtin 1
 114 manual page.
 115 .Sh EXIT STATUS
 116 .Ex -std
 117 .Sh EXAMPLES
 118 Terminate
 119 the processes with PIDs 142 and 157:
 120 .Pp
 121 .Dl "kill 142 157"
 122 .Pp
 123 Send the hangup signal
 124 .Pq Dv SIGHUP
 125 to the process with PID 507:
 126 .Pp
 127 .Dl "kill -s HUP 507"
 128 .Pp
 129 Terminate the process group with PGID 117:
 130 .Pp
 131 .Dl "kill -- -117"
 132 .Sh SEE ALSO
 133 .Xr builtin 1 ,
 134 .Xr csh 1 ,
 135 .Xr killall 1 ,
 136 .Xr ps 1 ,
 137 .Xr sh 1 ,
 138 .Xr kill 2 ,
 139 .Xr sigaction 2
 140 .Sh STANDARDS
 141 The
 142 .Nm
 143 utility is expected to be
 144 .St -p1003.2
 145 compatible.
 146 .Sh HISTORY
 147 A
 148 .Nm
 149 command appeared in
 150 .At v3 .
 151 .Sh BUGS
 152 A replacement for the command
 153 .Dq Li kill 0
 154 for
 155 .Xr csh 1
 156 users should be provided.