new vm

[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 0a12964..06610a2 100644 (file)
--- a/usr/src/bin/kill/kill.1
+++ b/usr/src/bin/kill/kill.1
@@ -1,67 +1,89 @@
-.\" Copyright (c) 1980 Regents of the University of California.
-.\" All rights reserved.  The Berkeley software License Agreement
-.\" specifies the terms and conditions for redistribution.
+.\" Copyright (c) 1980, 1990 The Regents of the University of California.
+.\" All rights reserved.

 .\"
 .\"

-.\"    @(#)kill.1      6.1 (Berkeley) %G%
+.\" %sccs.include.redist.man%

 .\"
 .\"

-.TH KILL 1 ""
-.UC 4
-.SH NAME
-kill \- terminate a process with extreme prejudice
-.SH SYNOPSIS
-.B kill
-[
-.BR \- sig
-]
-processid ...
-.br
-.B kill
-.B \-l
-.SH DESCRIPTION
-.I Kill
-sends the TERM (terminate, 15) signal to the specified processes.
-If a signal name or number preceded by `\-' is given
-as first argument, that signal is sent instead of
-terminate
-(see
-.IR  sigvec (2)).
-The signal names are listed by
-`kill \-l', and are as given in
-.I /usr/include/signal.h,
+.\"     @(#)kill.1     6.5 (Berkeley) %G%
+.\"
+.Vx
+.Vx
+.Dd 
+.Dt KILL 1
+.Os
+.Sh NAME
+.Nm kill
+.Nd terminate or signal a process
+.Sh SYNOPSIS
+.Nm kill
+.Op Fl signal_name
+.Ar pid
+\&...
+.Nm kill
+.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.
+.Pp
+Options available:
+.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.
 stripped of the common SIG prefix.

-.PP
-The terminate signal will kill processes that do not catch the signal;
-`kill \-9 ...' is a sure kill, as the KILL (9) signal cannot be caught.
-By convention, if process number 0 is specified, all members
-in the process group (i.e. processes resulting from 
-the current login) are signaled (but beware: this works only
-if you use
-.IR sh (1);
-not if you use
-.IR csh (1).)
-The killed processes must belong
-to the current user unless
-he is the super-user.
-.PP
-The process number of an asynchronous process
-started with `&' is reported by the shell.
-Process numbers can also be found by using
-.I Kill
+.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
+.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
+.Pp
+.Nm Kill

 is a built-in to
 is a built-in to

-.IR csh (1);
-it allows job specifiers ``%...''
+.Xr csh  1  ;
+it allows job specifiers of the form ``%...'' as arguments

 so process id's are not as often used as
 so process id's are not as often used as

-.I kill
+.Nm kill

 arguments.
 See
 arguments.
 See

-.IR csh (1)
+.Xr csh  1

 for details.
 for details.

-.SH "SEE ALSO"
-csh(1), ps(1), kill(2), sigvec(2)
-.SH BUGS
-An option to kill process groups ala
-.IR killpg (2)
-should be provided; a replacement for ``kill 0''
+.Sh SEE ALSO
+.Xr csh 1 ,
+.Xr ps 1 ,
+.Xr kill 2 ,
+.Xr sigvec 2
+.Sh HISTORY
+A
+.Nm kill
+command appeared in Version 6 AT&T Unix.
+.Sh BUGS
+A replacement for
+.Dq Li kill 0

 for
 for

-.IR csh (1)
+.Xr csh  1

 users should be provided.
 users should be provided.