[unix-history] / usr / src / bin / kill / kill.1

.\" Copyright (c) 1980 Regents of the University of California.
.\" All rights reserved.  The Berkeley software License Agreement
.\" specifies the terms and conditions for redistribution.
.\"
.\"	@(#)kill.1	6.1 (Berkeley) %G%
.\"
.TH KILL 1 ""
.UC 4
.SH NAME
kill \- terminate a process with extreme prejudice
.SH SYNOPSIS
.B kill
[
.BR \- sig
]
processid ...
.br
.B kill
.B \-l
.SH DESCRIPTION
.I Kill
sends the TERM (terminate, 15) signal to the specified processes.
If a signal name or number preceded by `\-' is given
as first argument, that signal is sent instead of
terminate
(see
.IR  sigvec (2)).
The signal names are listed by
`kill \-l', and are as given in
.I /usr/include/signal.h,
stripped of the common SIG prefix.
.PP
The terminate signal will kill processes that do not catch the signal;
`kill \-9 ...' is a sure kill, as the KILL (9) signal cannot be caught.
By convention, if process number 0 is specified, all members
in the process group (i.e. processes resulting from 
the current login) are signaled (but beware: this works only
if you use
.IR sh (1);
not if you use
.IR csh (1).)
The killed processes must belong
to the current user unless
he is the super-user.
.PP
The process number of an asynchronous process
started with `&' is reported by the shell.
Process numbers can also be found by using
.I Kill
is a built-in to
.IR csh (1);
it allows job specifiers ``%...''
so process id's are not as often used as
.I kill
arguments.
See
.IR csh (1)
for details.
.SH "SEE ALSO"
csh(1), ps(1), kill(2), sigvec(2)
.SH BUGS
An option to kill process groups ala
.IR killpg (2)
should be provided; a replacement for ``kill 0''
for
.IR csh (1)
users should be provided.
Commit	Line	Data
3d86f03a KM	1	.\" Copyright (c) 1980 Regents of the University of California.
	2	.\" All rights reserved. The Berkeley software License Agreement
	3	.\" specifies the terms and conditions for redistribution.
	4	.\"
2c9c5bb4	5	.\" @(#)kill.1 6.1 (Berkeley) %G%
3d86f03a	6	.\"
2c9c5bb4	7	.TH KILL 1 ""
3d86f03a KM	8	.UC 4
	9	.SH NAME
	10	kill \- terminate a process with extreme prejudice
	11	.SH SYNOPSIS
	12	.B kill
	13	[
	14	.BR \- sig
	15	]
	16	processid ...
	17	.br
	18	.B kill
	19	.B \-l
	20	.SH DESCRIPTION
	21	.I Kill
	22	sends the TERM (terminate, 15) signal to the specified processes.
	23	If a signal name or number preceded by `\-' is given
	24	as first argument, that signal is sent instead of
	25	terminate
	26	(see
edebdd33	27	.IR sigvec (2)).
3d86f03a KM	28	The signal names are listed by
	29	`kill \-l', and are as given in
	30	.I /usr/include/signal.h,
	31	stripped of the common SIG prefix.
	32	.PP
	33	The terminate signal will kill processes that do not catch the signal;
	34	`kill \-9 ...' is a sure kill, as the KILL (9) signal cannot be caught.
	35	By convention, if process number 0 is specified, all members
	36	in the process group (i.e. processes resulting from
	37	the current login) are signaled (but beware: this works only
	38	if you use
	39	.IR sh (1);
	40	not if you use
	41	.IR csh (1).)
	42	The killed processes must belong
	43	to the current user unless
	44	he is the super-user.
	45	.PP
3d86f03a KM	46	The process number of an asynchronous process
	47	started with `&' is reported by the shell.
	48	Process numbers can also be found by using
	49	.I Kill
	50	is a built-in to
	51	.IR csh (1);
	52	it allows job specifiers ``%...''
	53	so process id's are not as often used as
	54	.I kill
	55	arguments.
	56	See
	57	.IR csh (1)
	58	for details.
	59	.SH "SEE ALSO"
edebdd33	60	csh(1), ps(1), kill(2), sigvec(2)
3d86f03a KM	61	.SH BUGS
	62	An option to kill process groups ala
	63	.IR killpg (2)
	64	should be provided; a replacement for ``kill 0''
	65	for
	66	.IR csh (1)
	67	users should be provided.