xref: /original-bsd/bin/kill/kill.1 (revision 0842ddeb)
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.2 (Berkeley) 04/28/95
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 s Ar signal_name
20.Ar pid
21\&...
22.Nm kill
23.Fl l
24.Op Ar exit_status
25.Nm kill
26.Fl signal_name
27.Ar pid
28\&...
29.Nm kill
30.Fl signal_number
31.Ar pid
32\&...
33.Sh DESCRIPTION
34The kill utility sends a signal to the processes specified
35by the pid operand(s).
36.Pp
37Only the super-user may send signals to other users' processes.
38.Pp
39The options are as follows:
40.Pp
41.Bl -tag -width Ds
42.It Fl s Ar signal_name
43A symbolic signal name specifying the signal to be sent instead of the
44default
45.Dv TERM .
46.It Fl l Op Ar exit_status
47If no operand is given, list the signal names; otherwise, write
48the signal name corresponding to
49.Ar exit_status .
50.It Fl signal_name
51A symbolic signal name specifying the signal to be sent instead of the
52default
53.Dv TERM .
54.It Fl signal_number
55A non-negative decimal integer, specifying the signal to be sent instead
56of the default
57.Dv TERM .
58.El
59.Pp
60The following pids have special meanings:
61.Bl -tag -width Ds -compact
62.It -1
63If superuser, broadcast the signal to all processes; otherwise broadcast
64to all processes belonging to the user.
65.El
66.Pp
67Some of the more commonly used signals:
68.Bl -tag -width Ds -compact
69.It 1
70HUP (hang up)
71.It 2
72INT (interrupt)
73.It 3
74QUIT (quit)
75.It 6
76ABRT (abort)
77.It 9
78KILL (non-catchable, non-ignorable kill)
79.It 14
80ALRM (alarm clock)
81.It 15
82TERM (software termination signal)
83.El
84.Pp
85.Nm Kill
86is a built-in to
87.Xr csh  1  ;
88it allows job specifiers of the form ``%...'' as arguments
89so process id's are not as often used as
90.Nm kill
91arguments.
92See
93.Xr csh  1
94for details.
95.Sh SEE ALSO
96.Xr csh 1 ,
97.Xr ps 1 ,
98.Xr kill 2 ,
99.Xr sigvec 2
100.Sh STANDARDS
101The
102.Nm kill
103function is expected to be
104.St -p1003.2
105compatible.
106.Sh HISTORY
107A
108.Nm kill
109command appeared in
110.At v6 .
111.Sh BUGS
112A replacement for the command
113.Dq Li kill 0
114for
115.Xr csh  1
116users should be provided.
117