plan9port/man/man1/kill.1
Russ Cox 977b25a76a tmac: introduce real manual reference macro instead of overloading IR
The overloading of IR emits magic \X'...' sequences that turn into HTML manual links.
But not all such IR invocations should be manual links;
those had to be written to avoid the IR macro before.
Worse, the \X'...' ending the IR causes troff to emit only a single space after a period.

Defining a new IM macro for manual references fixes both problems.

Fixes #441.
2020-08-13 23:43:43 -04:00

69 lines
1.1 KiB
Groff

.TH KILL 1
.SH NAME
kill, slay, start, stop \- print commands to manipulate processes
.SH SYNOPSIS
.B kill
.I name ...
.PP
.B slay
.I name ...
.PP
.B start
.I name ...
.PP
.B stop
.I name ...
.SH DESCRIPTION
.I Kill
prints commands that will cause all processes with
.I name
and owned by the current user to be terminated.
Each command is commented with an output line from
.IM ps (1)
describing the process that would be killed.
Use the
.B send
command of
.IM 9term (1) ,
or pipe the output of
.I kill
into
.IM rc (1)
or
.IM sh (1)
to execute the commands.
.PP
.I Kill
suggests sending a Unix
.B TERM
signal to the process;
sending a
.B KILL
signal is a surer, if heavy handed, kill,
but is necessary if the offending process is
ignoring signals.
The
.I slay
command prints commands to do this.
.PP
.I Stop
prints commands to pause execution of processes
by sending them the
.B STOP
signal.
.PP
.I Start
prints commands to restart stopped processes by sending them
the
.B CONT
signal.
.SH SOURCE
.B \*9/bin
.SH "SEE ALSO"
.IM ps (1) ,
.IM notify (3)
.SH BUGS
.I Stop
and
.I start
should limit themselves to currently running or stopped processes.