386BSD 0.1 development

[unix-history] / usr / src / bin / kill / kill.1

diff --git a/usr/src/bin/kill/kill.1 b/usr/src/bin/kill/kill.1
index 06610a2..810cb28 100644 (file)
--- a/usr/src/bin/kill/kill.1
+++ b/usr/src/bin/kill/kill.1
@@ -1,13 +1,40 @@
 .\" Copyright (c) 1980, 1990 The Regents of the University of California.
 .\" All rights reserved.
 .\"
 .\" Copyright (c) 1980, 1990 The Regents of the University of California.
 .\" All rights reserved.
 .\"

-.\" %sccs.include.redist.man%
+.\" This code is derived from software contributed to Berkeley by
+.\" the Institute of Electrical and Electronics Engineers, Inc.

 .\"
 .\"

-.\"     @(#)kill.1     6.5 (Berkeley) %G%
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\"    notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\"    notice, this list of conditions and the following disclaimer in the
+.\"    documentation and/or other materials provided with the distribution.
+.\" 3. All advertising materials mentioning features or use of this software
+.\"    must display the following acknowledgement:
+.\"    This product includes software developed by the University of
+.\"    California, Berkeley and its contributors.
+.\" 4. Neither the name of the University nor the names of its contributors
+.\"    may be used to endorse or promote products derived from this software
+.\"    without specific prior written permission.

 .\"
 .\"

-.Vx
-.Vx
-.Dd 
+.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
+.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
+.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
+.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
+.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+.\" SUCH DAMAGE.
+.\"
+.\"    @(#)kill.1      6.8 (Berkeley) 7/27/91
+.\"
+.Dd July 27, 1991

 .Dt KILL 1
 .Os
 .Sh NAME
 .Dt KILL 1
 .Os
 .Sh NAME


@@ -19,48 +46,50 @@
 .Ar pid
 \&...
 .Nm kill
 .Ar pid
 \&...
 .Nm kill

+.Op Fl signal_number
+.Ar pid
+\&...
+.Nm kill

 .Op Fl l
 .Sh DESCRIPTION
 .Op Fl l
 .Sh DESCRIPTION

-The kill utility sends a signal to the process(es) specified
-by each pid operand. It is used to kill runaway or misbegotten
-processes, such as those
-.Em backgrounded
-with
-.Sq Li \&& .
-.Nm Kill
-is intelligent about who owns a process.
+The kill utility sends the
+.Dv TERM
+signal to the processes specified
+by the pid operand(s).
+.Pp
+Only the super-user may send signals to other users' processes.

 .Pp
 .Pp

-Options available:
+The options are as follows:

 .Pp
 .Pp

-.Tw Ds
-.Tp Fl signal_name
-A symbolic signal name. To find out all the possible signal names
-do a
-.Li kill -l .
-.Tp Fl l
-Available signal names are listed and are as found in
-.Pa /usr/include/signal.h ,
-stripped of the common SIG prefix.
-.Tp Fl signal_number
-A (nonnegative) decimal integer, representing the signal
-to be used instead of TERM as the sig argument in
-the effective call to
-.Xr kill 2 .
-.Tp
+.Bl -tag -width Ds
+.It Fl l
+List the signal names.
+.It Fl signal_name
+A symbolic signal name specifying the signal to be sent instead of the
+default
+.Dv TERM .
+The
+.Fl l
+option displays the signal names.
+.It Fl signal_number
+A non-negative decimal integer, specifying the signal to be sent instead
+of the default
+.Dv TERM .
+.El

 .Pp
 .Pp

-Some of the more commonly used signals with kill:
-.Ds I
-.Cw XXX TERM
-.Cl -1 -1      (broadcast to all processes, super user only)
-.Cl 0  0       (sh(1) only, signals all members of process group)
-.Cl 2  INT     (interupt)
-.Cl 3  QUIT    (quit)
-.Cl 6  ABRT    (abort)
-.Cl 9  KILL    (non-catchable non-ignorable kill)
-.Cl 14 ALRM    (alarm clock)
-.Cl 15 TERM    (software termination signal)
-.Cw
-.De
+Some of the more commonly used signals:
+.Bd -ragged -offset indent -compact
+.Bl -column XXX TERM
+.It -1 -1      (broadcast to all processes, super-user only)
+.It 0  0       (sh(1) only, signals all members of process group)
+.It 2  INT     (interupt)
+.It 3  QUIT    (quit)
+.It 6  ABRT    (abort)
+.It 9  KILL    (non-catchable, non-ignorable kill)
+.It 14 ALRM    (alarm clock)
+.It 15 TERM    (software termination signal)
+.El
+.Ed

 .Pp
 .Nm Kill
 is a built-in to
 .Pp
 .Nm Kill
 is a built-in to


@@ -80,9 +109,10 @@ for details.
 .Sh HISTORY
 A
 .Nm kill
 .Sh HISTORY
 A
 .Nm kill

-command appeared in Version 6 AT&T Unix.
+command appeared in
+.At v6 .

 .Sh BUGS
 .Sh BUGS

-A replacement for
+A replacement for the command

 .Dq Li kill 0
 for
 .Xr csh  1
 .Dq Li kill 0
 for
 .Xr csh  1