diff options
Diffstat (limited to 'misc-utils/kill.1')
| -rw-r--r-- | misc-utils/kill.1 | 111 |
1 files changed, 111 insertions, 0 deletions
diff --git a/misc-utils/kill.1 b/misc-utils/kill.1 new file mode 100644 index 0000000..09d30e9 --- /dev/null +++ b/misc-utils/kill.1 @@ -0,0 +1,111 @@ +.\" Copyright 1994 Salvatore Valente (svalente@mit.edu) +.\" Copyright 1992 Rickard E. Faith (faith@cs.unc.edu) +.\" May be distributed under the GNU General Public License +.TH KILL 1 "February 2011" "util-linux" "User Commands" +.SH NAME +kill \- terminate a process +.SH SYNOPSIS +.B kill +.RB [ \-s +.IR signal | \fB\-p\fP ] +.RB [ \-q +.IR sigval ] +.RB [ \-a ] +.RB [ \-\- ] +.IR pid ... +.br +.B kill -l +.RI [ signal ] +.SH DESCRIPTION +The command +.B kill +sends the specified signal to the specified process or process group. +If no signal is specified, the TERM signal is sent. The TERM signal +will kill processes which do not catch this signal. For other processes, +it may be necessary to use the KILL (9) signal, since this signal cannot +be caught. +.PP +Most modern shells have a builtin kill function, with a usage rather similar +to that of the command described here. The `-a' and `-p' options, +and the possibility to specify processes by command name are a local extension. +.PP +If sig is 0, then no signal is sent, but error checking is still performed. +.SH OPTIONS +.TP +.IR pid ... +Specify the list of processes that +.B kill +should signal. Each +.I pid +can be one of five things: + +.RS +.TP +.I n +where +.I n +is larger than 0. The process with pid +.I n +will be signaled. +.TP +.B 0 +All processes in the current process group are signaled. +.TP +.B -1 +All processes with pid larger than 1 will be signaled. +.TP +.BI - n +where +.I n +is larger than 1. +All processes in process group +.I n +are signaled. When an argument of the form `-n' is given, +and it is meant to denote a process group, +either the signal must be specified first, or the argument must be preceded +by a `--' option, otherwise it will be taken as the signal to send. +.TP +.I commandname +All processes invoked using that name will be signaled. +.RE +.TP +.BI \-s " signal" +Specify the signal to send. +The signal may be given as a signal name or number. +.TP +.B \-l +Print a list of signal names. These are found in +.I /usr/include/linux/signal.h +.TP +.B \-a +Do not restrict the commandname-to-pid conversion to processes +with the same uid as the present process. +.TP +.B \-p +Specify that +.B kill +should only print the process id (pid) +of the named processes, and not send any signals. +.TP +.BI \-q " sigval" +Use +.BR sigqueue (2) +rather than +.BR kill (2) +and the sigval argument is used to specify an integer to be sent with the +signal. If the receiving process has installed a handler for this signal using +the SA_SIGINFO flag to +.BR sigaction (2), +then it can obtain this data via the si_value field of the siginfo_t structure. +.SH "SEE ALSO" +.BR bash (1), +.BR tcsh (1), +.BR kill (2), +.BR sigvec (2), +.BR signal (7) +.SH AUTHOR +Taken from BSD 4.4. The ability to translate process names to process +ids was added by Salvatore Valente <svalente@mit.edu>. +.SH AVAILABILITY +The kill command is part of the util-linux package and is available from +ftp://ftp.kernel.org/pub/linux/utils/util-linux/. |