xref: /csrg-svn/bin/kill/kill.1 (revision 68983)
160670Sbostic.\" Copyright (c) 1980, 1990, 1993
260670Sbostic.\"	The Regents of the University of California.  All rights reserved.
319157Smckusick.\"
450193Sbostic.\" This code is derived from software contributed to Berkeley by
550193Sbostic.\" the Institute of Electrical and Electronics Engineers, Inc.
650193Sbostic.\"
750623Scael.\" %sccs.include.redist.roff%
819157Smckusick.\"
9*68983Sbostic.\"	@(#)kill.1	8.2 (Berkeley) 04/28/95
1043699Scael.\"
1143699Scael.Dd
1243699Scael.Dt KILL 1
1347309Scael.Os
1443699Scael.Sh NAME
1543699Scael.Nm kill
1643699Scael.Nd terminate or signal a process
1743699Scael.Sh SYNOPSIS
1843699Scael.Nm kill
19*68983Sbostic.Op Fl s Ar signal_name
2043699Scael.Ar pid
2143699Scael\&...
2243699Scael.Nm kill
23*68983Sbostic.Fl l
24*68983Sbostic.Op Ar exit_status
25*68983Sbostic.Nm kill
26*68983Sbostic.Fl signal_name
2750084Sbostic.Ar pid
2850084Sbostic\&...
2950084Sbostic.Nm kill
30*68983Sbostic.Fl signal_number
31*68983Sbostic.Ar pid
32*68983Sbostic\&...
3343699Scael.Sh DESCRIPTION
34*68983SbosticThe kill utility sends a signal to the processes specified
3550084Sbosticby the pid operand(s).
3644955Scael.Pp
3750084SbosticOnly the super-user may send signals to other users' processes.
3844955Scael.Pp
3950084SbosticThe options are as follows:
4050084Sbostic.Pp
4150623Scael.Bl -tag -width Ds
42*68983Sbostic.It Fl s Ar signal_name
43*68983SbosticA symbolic signal name specifying the signal to be sent instead of the
44*68983Sbosticdefault
45*68983Sbostic.Dv TERM .
46*68983Sbostic.It Fl l Op Ar exit_status
47*68983SbosticIf no operand is given, list the signal names; otherwise, write
48*68983Sbosticthe signal name corresponding to
49*68983Sbostic.Ar exit_status .
5050623Scael.It Fl signal_name
5150084SbosticA symbolic signal name specifying the signal to be sent instead of the
5250623Scaeldefault
5350623Scael.Dv TERM .
5450623Scael.It Fl signal_number
5550084SbosticA non-negative decimal integer, specifying the signal to be sent instead
5650623Scaelof the default
5750623Scael.Dv TERM .
5850623Scael.El
5943699Scael.Pp
60*68983SbosticThe following pids have special meanings:
61*68983Sbostic.Bl -tag -width Ds -compact
62*68983Sbostic.It -1
63*68983SbosticIf superuser, broadcast the signal to all processes; otherwise broadcast
64*68983Sbosticto all processes belonging to the user.
65*68983Sbostic.El
66*68983Sbostic.Pp
6750084SbosticSome of the more commonly used signals:
68*68983Sbostic.Bl -tag -width Ds -compact
69*68983Sbostic.It 1
70*68983SbosticHUP (hang up)
71*68983Sbostic.It 2
72*68983SbosticINT (interrupt)
73*68983Sbostic.It 3
74*68983SbosticQUIT (quit)
75*68983Sbostic.It 6
76*68983SbosticABRT (abort)
77*68983Sbostic.It 9
78*68983SbosticKILL (non-catchable, non-ignorable kill)
79*68983Sbostic.It 14
80*68983SbosticALRM (alarm clock)
81*68983Sbostic.It 15
82*68983SbosticTERM (software termination signal)
8350623Scael.El
8443699Scael.Pp
8543699Scael.Nm Kill
8619157Smckusickis a built-in to
8743699Scael.Xr csh  1  ;
8827202Slepreauit allows job specifiers of the form ``%...'' as arguments
8919157Smckusickso process id's are not as often used as
9043699Scael.Nm kill
9119157Smckusickarguments.
9219157SmckusickSee
9343699Scael.Xr csh  1
9419157Smckusickfor details.
9543699Scael.Sh SEE ALSO
9643699Scael.Xr csh 1 ,
9743699Scael.Xr ps 1 ,
9843699Scael.Xr kill 2 ,
9943699Scael.Xr sigvec 2
100*68983Sbostic.Sh STANDARDS
101*68983SbosticThe
102*68983Sbostic.Nm kill
103*68983Sbosticfunction is expected to be
104*68983Sbostic.St -p1003.2
105*68983Sbosticcompatible.
10643699Scael.Sh HISTORY
10743699ScaelA
10843699Scael.Nm kill
10950623Scaelcommand appeared in
11050623Scael.At v6 .
11143699Scael.Sh BUGS
11250623ScaelA replacement for the command
11343699Scael.Dq Li kill 0
11419157Smckusickfor
11543699Scael.Xr csh  1
11619157Smckusickusers should be provided.
117