.\" Automatically generated by Pod::Man 2.28 (Pod::Simple 3.30)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is turned on, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{
.    if \nF \{
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
.    \" fudge factors for nroff and troff
.if n \{\
.    ds #H 0
.    ds #V .8m
.    ds #F .3m
.    ds #[ \f1
.    ds #] \fP
.\}
.if t \{\
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.    ds #V .6m
.    ds #F 0
.    ds #[ \&
.    ds #] \&
.\}
.    \" simple accents for nroff and troff
.if n \{\
.    ds ' \&
.    ds ` \&
.    ds ^ \&
.    ds , \&
.    ds ~ ~
.    ds /
.\}
.if t \{\
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
.    \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.    \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.    \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.    ds : e
.    ds 8 ss
.    ds o a
.    ds d- d\h'-1'\(ga
.    ds D- D\h'-1'\(hy
.    ds th \o'bp'
.    ds Th \o'LP'
.    ds ae ae
.    ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
.IX Title "KILL 1"
.TH KILL 1 "2001-06-06" "perl v5.20.0" "User Contributed Perl Documentation"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
kill \- send signals to a process
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
\&\fBkill\fR
[ \fB\-s\fR \fIsignalname\fR \f(CW\*(C`PIDS ...\*(C'\fR ]
[ \fB\-signalname\fR \f(CW\*(C`PIDS ...\*(C'\fR ]
[ \fB\-signalnumber\fR \f(CW\*(C`PIDS ...\*(C'\fR ]
[ \f(CW\*(C`PIDS ...\*(C'\fR ]
[ \fB\-l\fR ]
[ \fB\-h\fR ]
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
\&\fBkill\fR sends a signal to all \s-1PIDS\s0 specified on the command line.  This is
typically done to cause a process to terminate and/or to reload configuration
files, etc.  Signal handlers are specified per program, so the effects of a
received signal may vary.
.SH "OPTIONS AND ARGUMENTS"
.IX Header "OPTIONS AND ARGUMENTS"
.IP "\fI\-s\fR	This parameter takes a single argument of a signal name (see \-l) to be sent to the specified PIDs." 4
.IX Item "-s This parameter takes a single argument of a signal name (see -l) to be sent to the specified PIDs."
.PD 0
.ie n .IP "\fI\-signalname\fR	A short form of the ""\-s signalname"" parameter." 4
.el .IP "\fI\-signalname\fR	A short form of the \f(CW\-s signalname\fR parameter." 4
.IX Item "-signalname A short form of the -s signalname parameter."
.IP "\fI\-signalnumber\fR	This parameter specifies that the given signal number should be sent to the specified \s-1PID\s0 listing." 4
.IX Item "-signalnumber This parameter specifies that the given signal number should be sent to the specified PID listing."
.IP "\fI\-l\fR	Display a listing of all available signals on the current system." 4
.IX Item "-l Display a listing of all available signals on the current system."
.IP "\fI\-h\fR	Display the usage help message." 4
.IX Item "-h Display the usage help message."
.PD
.SH "NOTES"
.IX Header "NOTES"
If no signal is specified on the command line, \s-1SIGTERM\s0 is sent to the
specified PIDs.
.PP
kill returns 0 on success or >0 if an error occurred.
.PP
kill is built-in to \fIcsh\fR\|(1);  See \fIcsh\fR\|(1) for details.
.PP
Only the super-user may send signals to other users' processes.
.PP
This version of kill does not support \fI\-l [signal]\fR since there didn't seem
to be any use to the parameter (it didn't work on any platform I tried
either.)
.PP
Signal names may have the \fI\s-1SIG\s0\fR prefix.  i.e.: \f(CW\*(C`kill \-HUP\*(C'\fR and \f(CW\*(C`kill
\&\-SIGHUP\*(C'\fR are equivalent.
.PP
The signal list \f(CW\*(C`kill \-l\*(C'\fR displays in an \*(L"extended\*(R" form which lists both
the signal name and the signal number for easy reference.
.SH "HISTORY"
.IX Header "HISTORY"
Perl version rewritten for the Perl Power Tools project from the
description of the kill program in OpenBSD.
.SH "AUTHOR"
.IX Header "AUTHOR"
Theo Van Dinter (felicity@kluge.net)
.SH "SEE ALSO"
.IX Header "SEE ALSO"
\&\fIcsh\fR\|(1), \fIps\fR\|(1), \fIkill\fR\|(2)
.SH "POD ERRORS"
.IX Header "POD ERRORS"
Hey! \fBThe above document had some coding errors, which are explained below:\fR
.IP "Around line 88:" 4
.IX Item "Around line 88:"
\&'=item' outside of any '=over'
.IP "Around line 100:" 4
.IX Item "Around line 100:"
You forgot a '=back' before '=head1'