]> git.lizzy.rs Git - plan9front.git/blob - sys/man/1/kill
/sys/man/*/*: fix perms (sorry)
[plan9front.git] / sys / man / 1 / kill
1 .TH KILL 1
2 .SH NAME
3 kill, slay, broke, dontkill \- print commands to kill processes
4 .SH SYNOPSIS
5 .B kill
6 .I name ...
7 .PP
8 .B slay
9 .I name ...
10 .PP
11 .B broke
12 [
13 .I user
14 ]
15 .PP
16 .B dontkill
17 .I regexp
18 .SH DESCRIPTION
19 .I Kill
20 prints commands that will cause all processes called
21 .I name
22 and owned by the current user to be terminated.
23 Use the
24 .B send
25 command of
26 .IR rio (1),
27 or pipe the output of
28 .I kill
29 into
30 .IR rc (1)
31 to execute the commands.
32 .PP
33 .I Kill
34 suggests sending a
35 .B "kill"
36 note to the process; the same
37 message delivered to the process's
38 .B ctl
39 file (see
40 .IR proc (3))
41 is a surer, if heavy handed, kill,
42 but is necessary if the offending process is
43 ignoring notes.
44 The
45 .I slay
46 command prints commands to do this.
47 .PP
48 .I Broke
49 prints commands that will cause all processes
50 in the
51 .I Broken
52 state
53 and owned by
54 .I user
55 (by default, the current user)
56 to go away.
57 When a process dies because of an error caught by
58 the system, it may linger in the
59 .I Broken
60 state to allow examination with a debugger.
61 Executing the commands printed by
62 .I broke
63 lets the system reclaim the resources used by
64 the broken processes.
65 .PP
66 .I Dontkill
67 flags processes matching the program name
68 .I regexp
69 as not to be killed in the event of memory
70 exhaustion. This is usually run from
71 .B termrc
72 and
73 .B cpurc
74 (see
75 .IR cpurc (8))
76 to protect important system processes from
77 getting killed.
78 .SH SOURCE
79 .B /rc/bin/kill
80 .br
81 .B /rc/bin/broke
82 .br
83 .B /rc/bin/dontkill
84 .SH "SEE ALSO"
85 .IR ps (1),
86 .IR stop (1),
87 .IR notify (2),
88 .IR proc (3)