man page stuff
[procps:procps.git] / kill.1
1 '\" t
2 .\" (The preceding line is a note to broken versions of man to tell
3 .\" them to pre-process this man page with tbl)
4 .\" Man page for kill.
5 .\" Licensed under version 2 of the GNU General Public License.
6 .\" Written by Albert Cahalan; converted to a man page by
7 .\" Michael K. Johnson
8 .TH KILL 1 "November 21, 1999" "Linux" "Linux User's Manual"
9 .SH NAME
10 kill \- send a signal to a process
11
12 .SH SYNOPSIS
13 .TS
14 l l.
15 kill pid ...    Send SIGTERM to every process listed.
16 kill -signal pid ...    Send a signal to every process listed.
17 kill -s signal pid ...  Send a signal to every process listed.
18 kill -l List all signal names.
19 kill -L List all signal names in a nice table.
20 kill -l signal  Convert a signal number into a name.
21 kill -V,--version       Show version of program
22 .TE
23
24 .SH DESCRIPTION
25 The default signal for kill is TERM. Use -l or -L to list available signals.
26 Particularly useful signals include HUP, INT, KILL, STOP, CONT, and 0.
27 Alternate signals may be specified in three ways: -9 -SIGKILL -KILL.
28 Negative PID values may be used to choose whole process groups; see the
29 PGID column in ps command output. A PID of -1 is special; it indicates
30 all processes except the kill process itself and init.
31
32 .SH SIGNALS
33 The signals listed below may be available for use with kill.
34 When known constant, numbers and default behavior are shown.
35
36 .TS
37 lB rB lB lB
38 lfCW r l l.
39 Name    Num     Action  Description
40 .TH
41 0       0       n/a     exit code indicates if a signal may be sent
42 ALRM    14      exit
43 HUP     1       exit
44 INT     2       exit
45 KILL    9       exit    this signal may not be blocked
46 PIPE    13      exit
47 POLL            exit
48 PROF            exit
49 TERM    15      exit
50 USR1            exit
51 USR2            exit
52 VTALRM          exit
53 STKFLT          exit    may not be implemented
54 PWR             ignore  may exit on some systems
55 WINCH           ignore
56 CHLD            ignore
57 URG             ignore
58 TSTP            stop    may interact with the shell
59 TTIN            stop    may interact with the shell
60 TTOU            stop    may interact with the shell
61 STOP            stop    this signal may not be blocked
62 CONT            restart continue if stopped, otherwise ignore
63 ABRT    6       core
64 FPE     8       core
65 ILL     4       core
66 QUIT    3       core
67 SEGV    11      core
68 TRAP    5       core
69 SYS             core    may not be implemented
70 EMT             core    may not be implemented
71 BUS             core    core dump may fail
72 XCPU            core    core dump may fail
73 XFSZ            core    core dump may fail
74 .TE
75
76 .SH NOTES
77 Your shell (command line interpreter) may have a built-in kill command.
78 You may need to run the command described here as /bin/kill to solve
79 the conflict.
80
81 .SH EXAMPLES
82
83 .SS
84 .B "kill -9 -1"
85 .nf
86 Kill all processes you can kill.
87 .fi
88 .PP
89 .SS
90 .B "kill -l 11"
91 .nf
92 Translate number 11 into a signal name.
93 .fi
94 .PP
95 .SS
96 .B "kill -L"
97 .nf
98 List the available signal choices in a nice table.
99 .fi
100 .PP
101 .SS
102 .B "kill 123 543 2341 3453"
103 .nf
104 Send the default signal, SIGTERM, to all those processes.
105 .fi
106 .PP
107 .SH "SEE ALSO"
108 pkill(1) skill(1) kill(2) renice(1) nice(1) signal(7) killall(1)
109
110 .SH STANDARDS
111 This command meets appropriate standards. The -L flag is Linux-specific.
112
113 .SH AUTHOR
114 Albert Cahalan <albert@users.sf.net> wrote kill in 1999 to replace a
115 bsdutils one that was not standards compliant. The util-linux one might
116 also work correctly.
117
118 Please send bug reports to <procps-feedback@lists.sf.net>