build: Better Build System

1 files changed, 70 insertions, 0 deletions

diff --git a/static/plan9-4e/man1/kill.1 b/static/plan9-4e/man1/kill.1
new file mode 100644
index 00000000..a4abe8a2
--- /dev/null
+++ b/static/plan9-4e/man1/kill.1
@@ -0,0 +1,70 @@
+.TH KILL 1
+.SH NAME
+kill, slay, broke \- print commands to kill processes
+.SH SYNOPSIS
+.B kill
+.I name ...
+.PP
+.B slay
+.I name ...
+.PP
+.B broke
+[
+.I user
+]
+.SH DESCRIPTION
+.I Kill
+prints commands that will cause all processes called
+.I name
+and owned by the current user to be terminated.
+Use the
+.B send
+command of
+.IR rio (1),
+or pipe the output of
+.I kill
+into
+.IR rc (1)
+to execute the commands.
+.PP
+.I Kill
+suggests sending a
+.B "kill"
+note to the process; the same
+message delivered to the process's
+.B ctl
+file (see
+.IR proc (3))
+is a surer, if heavy handed, kill,
+but is necessary if the offending process is
+ignoring notes.
+The
+.I slay
+command prints commands to do this.
+.PP
+.I Broke
+prints commands that will cause all processes
+in the
+.I Broken
+state
+and owned by
+.I user
+(by default, the current user)
+to go away.
+When a process dies because of an error caught by
+the system, it may linger in the
+.I Broken
+state to allow examination with a debugger.
+Executing the commands printed by
+.I broke
+lets the system reclaim the resources used by
+the broken processes.
+.SH SOURCE
+.B /rc/bin/kill
+.br
+.B /rc/bin/broke
+.SH "SEE ALSO"
+.IR ps (1),
+.IR stop (1),
+.IR notify (2),
+.IR proc (3)