xref: /original-bsd/bin/kill/kill.1 (revision b6e6114e)
1.\" Copyright (c) 1980, 1990, 1993
2.\"	The Regents of the University of California.  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	8.1 (Berkeley) 05/31/93
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	(super-user broadcast to all processes, or user broadcast
58to user's processes)
59.It 0	0	(sh(1) only, signals all members of process group)
60.It 2	INT	(interrupt)
61.It 3	QUIT	(quit)
62.It 6	ABRT	(abort)
63.It 9	KILL	(non-catchable, non-ignorable kill)
64.It 14	ALRM	(alarm clock)
65.It 15	TERM	(software termination signal)
66.El
67.Ed
68.Pp
69.Nm Kill
70is a built-in to
71.Xr csh  1  ;
72it allows job specifiers of the form ``%...'' as arguments
73so process id's are not as often used as
74.Nm kill
75arguments.
76See
77.Xr csh  1
78for details.
79.Sh SEE ALSO
80.Xr csh 1 ,
81.Xr ps 1 ,
82.Xr kill 2 ,
83.Xr sigvec 2
84.Sh HISTORY
85A
86.Nm kill
87command appeared in
88.At v6 .
89.Sh BUGS
90A replacement for the command
91.Dq Li kill 0
92for
93.Xr csh  1
94users should be provided.
95