xref: /original-bsd/bin/kill/kill.1 (revision 58db4230)
1.\" Copyright (c) 1980, 1990 The Regents of the University of California.
2.\" All rights reserved.
3.\"
4.\" %sccs.include.redist.man%
5.\"
6.\"     @(#)kill.1	6.4 (Berkeley) 07/24/90
7.\"
8.Dd
9.Dt KILL 1
10.Os BSD 4.4
11.Sh NAME
12.Nm kill
13.Nd terminate or signal a process
14.Sh SYNOPSIS
15.Nm kill
16.Op Fl signal_name
17.Ar pid
18\&...
19.Nm kill
20.Op Fl l
21.Sh DESCRIPTION
22The kill utility sends a signal to the process(es) specified
23by each pid operand. It is used to kill runaway or misbegotten
24processes, such as those
25.Em backgrounded
26with
27.Sq Li \&& .
28.Nm Kill
29is intelligent about who owns a process.
30.Pp
31Options available:
32.Pp
33.Tw Ds
34.Tp Fl signal_name
35A symbolic signal name. To find out all the possible signal names
36do a
37.Li kill -l .
38.Tp Fl l
39Available signal names are listed and are as found in
40.Pa /usr/include/signal.h ,
41stripped of the common SIG prefix.
42.Tp Fl signal_number
43A (nonnegative) decimal integer, representing the signal
44to be used instead of TERM as the sig argument in
45the effective call to
46.Xr kill 2 .
47.Tp
48.Pp
49Some of the more commonly used signals with kill:
50.Ds I
51.Cw XXX TERM
52.Cl -1	-1	(broadcast to all processes, super user only)
53.Cl 0	0	(sh(1) only, signals all members of process group)
54.Cl 2	INT	(interupt)
55.Cl 3	QUIT	(quit)
56.Cl 6	ABRT	(abort)
57.Cl 9	KILL	(non-catchable non-ignorable kill)
58.Cl 14	ALRM	(alarm clock)
59.Cl 15	TERM	(software termination signal)
60.Cw
61.De
62.Pp
63.Nm Kill
64is a built-in to
65.Xr csh  1  ;
66it allows job specifiers of the form ``%...'' as arguments
67so process id's are not as often used as
68.Nm kill
69arguments.
70See
71.Xr csh  1
72for details.
73.Sh SEE ALSO
74.Xr csh 1 ,
75.Xr ps 1 ,
76.Xr kill 2 ,
77.Xr sigvec 2
78.Sh HISTORY
79A
80.Nm kill
81command appeared in Version 6 AT&T Unix.
82.Sh BUGS
83A replacement for
84.Dq Li kill 0
85for
86.Xr csh  1
87users should be provided.
88