xref: /original-bsd/bin/kill/kill.1 (revision e66a5d85)
1.\" Copyright (c) 1980, 1990 The Regents of the University of California.
2.\" All rights reserved.
3.\"
4.\" This code is derived from software contributed to Berkeley by
5.\" the Institute of Electrical and Electronics Engineers, Inc.
6.\"
7.\" %sccs.include.redist.roff%
8.\"
9.\"	@(#)kill.1	6.8 (Berkeley) 07/27/91
10.\"
11.Dd
12.Dt KILL 1
13.Os
14.Sh NAME
15.Nm kill
16.Nd terminate or signal a process
17.Sh SYNOPSIS
18.Nm kill
19.Op Fl signal_name
20.Ar pid
21\&...
22.Nm kill
23.Op Fl signal_number
24.Ar pid
25\&...
26.Nm kill
27.Op Fl l
28.Sh DESCRIPTION
29The kill utility sends the
30.Dv TERM
31signal to the processes specified
32by the pid operand(s).
33.Pp
34Only the super-user may send signals to other users' processes.
35.Pp
36The options are as follows:
37.Pp
38.Bl -tag -width Ds
39.It Fl l
40List the signal names.
41.It Fl signal_name
42A symbolic signal name specifying the signal to be sent instead of the
43default
44.Dv TERM .
45The
46.Fl l
47option displays the signal names.
48.It Fl signal_number
49A non-negative decimal integer, specifying the signal to be sent instead
50of the default
51.Dv TERM .
52.El
53.Pp
54Some of the more commonly used signals:
55.Bd -ragged -offset indent -compact
56.Bl -column XXX TERM
57.It -1	-1	(broadcast to all processes, super-user only)
58.It 0	0	(sh(1) only, signals all members of process group)
59.It 2	INT	(interupt)
60.It 3	QUIT	(quit)
61.It 6	ABRT	(abort)
62.It 9	KILL	(non-catchable, non-ignorable kill)
63.It 14	ALRM	(alarm clock)
64.It 15	TERM	(software termination signal)
65.El
66.Ed
67.Pp
68.Nm Kill
69is a built-in to
70.Xr csh  1  ;
71it allows job specifiers of the form ``%...'' as arguments
72so process id's are not as often used as
73.Nm kill
74arguments.
75See
76.Xr csh  1
77for details.
78.Sh SEE ALSO
79.Xr csh 1 ,
80.Xr ps 1 ,
81.Xr kill 2 ,
82.Xr sigvec 2
83.Sh HISTORY
84A
85.Nm kill
86command appeared in
87.At v6 .
88.Sh BUGS
89A replacement for the command
90.Dq Li kill 0
91for
92.Xr csh  1
93users should be provided.
94