docs: clean up kill and skill man pages
Signed-off-by: Sami Kerola <kerolasa@iki.fi>
This commit is contained in:
Sami Kerola
parent
b6578cb372
commit
3c77055c5e
135
kill.1
135
kill.1
@ -5,73 +5,57 @@
|
|||||||
.\" Licensed under version 2 of the GNU General Public License.
|
.\" Licensed under version 2 of the GNU General Public License.
|
||||||
.\" Written by Albert Cahalan; converted to a man page by
|
.\" Written by Albert Cahalan; converted to a man page by
|
||||||
.\" Michael K. Johnson
|
.\" Michael K. Johnson
|
||||||
.TH KILL 1 "November 21, 1999" "Linux" "Linux User's Manual"
|
.TH KILL 1 "October 2011" "procps-ng" "User Commands"
|
||||||
.SH NAME
|
.SH NAME
|
||||||
kill \- send a signal to a process
|
kill \- send a signal to a process
|
||||||
|
|
||||||
.SH SYNOPSIS
|
.SH SYNOPSIS
|
||||||
\fBkill\fR [ \-\fBsignal\fR | \-s \fBsignal\fR ] \fBpid\fR ...
|
.B kill
|
||||||
.br
|
[options] <pid> [...]
|
||||||
\fBkill\fR [ \-L | -V, \-\-version ]
|
|
||||||
.br
|
|
||||||
\fBkill\fR \-l [ \fBsignal\fR ]
|
|
||||||
|
|
||||||
.SH DESCRIPTION
|
.SH DESCRIPTION
|
||||||
The default signal for kill is TERM. Use \-l or \-L to list available signals.
|
The default signal for kill is TERM. Use
|
||||||
Particularly useful signals include HUP, INT, KILL, STOP, CONT, and 0.
|
.B \-l
|
||||||
Alternate signals may be specified in three ways: \-9 \-SIGKILL \-KILL.
|
or
|
||||||
Negative PID values may be used to choose whole process groups; see the
|
.B \-L
|
||||||
PGID column in ps command output. A PID of \-1 is special; it indicates
|
to list available signals. Particularly useful signals include HUP,
|
||||||
all processes except the kill process itself and init.
|
INT, KILL, STOP, CONT, and 0. Alternate signals may be specified in
|
||||||
|
three ways:
|
||||||
|
.BR \-9 ", " \-SIGKILL
|
||||||
|
or
|
||||||
|
.BR \-KILL .
|
||||||
|
Negative PID values may be used to choose whole process groups; see
|
||||||
|
the PGID column in ps command output. A PID of
|
||||||
|
.B \-1
|
||||||
|
is special; it indicates all processes except the kill process itself
|
||||||
|
and init.
|
||||||
|
.SH OPTIONS
|
||||||
|
.TP
|
||||||
|
.B <pid> [...]
|
||||||
|
Send signal to every <pid> listed.
|
||||||
|
.TP
|
||||||
|
.B \-<signal>
|
||||||
|
.TQ
|
||||||
|
.B \-s <signal>
|
||||||
|
Specify the
|
||||||
|
.B signal
|
||||||
|
to be sent. The signal can be specified by using name or number.
|
||||||
|
.TP
|
||||||
|
.B \-l
|
||||||
|
List signal names.
|
||||||
|
.TP
|
||||||
|
.B \-L
|
||||||
|
List signal names in a nice table.
|
||||||
|
.TP
|
||||||
|
.B \-l <signal>
|
||||||
|
Convert in between signal name and number.
|
||||||
|
.PD
|
||||||
.SH SIGNALS
|
.SH SIGNALS
|
||||||
The signals listed below may be available for use with kill.
|
The behavior of signals is explained in
|
||||||
When known constant, numbers and default behavior are shown.
|
.BR signal (7)
|
||||||
|
manual page.
|
||||||
.TS
|
|
||||||
lB rB lB lB
|
|
||||||
lfCW r l l.
|
|
||||||
Name Num Action Description
|
|
||||||
0 0 n/a exit code indicates if a signal may be sent
|
|
||||||
ALRM 14 exit
|
|
||||||
HUP 1 exit
|
|
||||||
INT 2 exit
|
|
||||||
KILL 9 exit cannot be blocked
|
|
||||||
PIPE 13 exit
|
|
||||||
POLL exit
|
|
||||||
PROF exit
|
|
||||||
TERM 15 exit
|
|
||||||
USR1 exit
|
|
||||||
USR2 exit
|
|
||||||
VTALRM exit
|
|
||||||
STKFLT exit might not be implemented
|
|
||||||
PWR ignore might exit on some systems
|
|
||||||
WINCH ignore
|
|
||||||
CHLD ignore
|
|
||||||
URG ignore
|
|
||||||
TSTP stop might interact with the shell
|
|
||||||
TTIN stop might interact with the shell
|
|
||||||
TTOU stop might interact with the shell
|
|
||||||
STOP stop cannot be blocked
|
|
||||||
CONT restart continue if stopped, otherwise ignore
|
|
||||||
ABRT 6 core
|
|
||||||
FPE 8 core
|
|
||||||
ILL 4 core
|
|
||||||
QUIT 3 core
|
|
||||||
SEGV 11 core
|
|
||||||
TRAP 5 core
|
|
||||||
SYS core might not be implemented
|
|
||||||
EMT core might not be implemented
|
|
||||||
BUS core core dump might fail
|
|
||||||
XCPU core core dump might fail
|
|
||||||
XFSZ core core dump might fail
|
|
||||||
.TE
|
|
||||||
|
|
||||||
.SH NOTES
|
.SH NOTES
|
||||||
Your shell (command line interpreter) may have a built-in kill command.
|
Your shell (command line interpreter) may have a built-in kill
|
||||||
You may need to run the command described here as /bin/kill to solve
|
command. You may need to run the command described here as /bin/kill
|
||||||
the conflict.
|
to solve the conflict.
|
||||||
|
|
||||||
.SH EXAMPLES
|
.SH EXAMPLES
|
||||||
.TP
|
.TP
|
||||||
.B kill \-9 \-1
|
.B kill \-9 \-1
|
||||||
@ -85,22 +69,25 @@ List the available signal choices in a nice table.
|
|||||||
.TP
|
.TP
|
||||||
.B kill 123 543 2341 3453
|
.B kill 123 543 2341 3453
|
||||||
Send the default signal, SIGTERM, to all those processes.
|
Send the default signal, SIGTERM, to all those processes.
|
||||||
|
|
||||||
.SH "SEE ALSO"
|
.SH "SEE ALSO"
|
||||||
.BR pkill (1),
|
|
||||||
.BR skill (1),
|
|
||||||
.BR kill (2),
|
.BR kill (2),
|
||||||
.BR renice (1),
|
.BR killall (1),
|
||||||
.BR nice (1),
|
.BR nice (1),
|
||||||
|
.BR pkill (1),
|
||||||
|
.BR renice (1),
|
||||||
.BR signal (7),
|
.BR signal (7),
|
||||||
.BR killall (1).
|
.BR skill (1)
|
||||||
|
|
||||||
.SH STANDARDS
|
.SH STANDARDS
|
||||||
This command meets appropriate standards. The \-L flag is Linux-specific.
|
This command meets appropriate standards. The
|
||||||
|
.B \-L
|
||||||
|
flag is Linux-specific.
|
||||||
.SH AUTHOR
|
.SH AUTHOR
|
||||||
Albert Cahalan <albert@users.sf.net> wrote kill in 1999 to replace a
|
.UR albert\@users.sf.net
|
||||||
bsdutils one that was not standards compliant. The util-linux one might
|
Albert Cahalan
|
||||||
also work correctly.
|
.UE
|
||||||
|
wrote kill in 1999 to replace a bsdutils one that was not standards
|
||||||
Please send bug reports to <procps@freelists.org>
|
compliant. The util-linux one might also work correctly.
|
||||||
|
.SH "REPORTING BUGS"
|
||||||
|
Please send bug reports to
|
||||||
|
.UR procps\@freelists.org
|
||||||
|
.UE
|
||||||
|
|||||||
195
skill.1
195
skill.1
@ -6,124 +6,109 @@
|
|||||||
.\" Written by Albert Cahalan, converted to a man page by
|
.\" Written by Albert Cahalan, converted to a man page by
|
||||||
.\" Michael K. Johnson
|
.\" Michael K. Johnson
|
||||||
.\"
|
.\"
|
||||||
.TH SKILL 1 "March 12, 1999" "Linux" "Linux User's Manual"
|
.TH SKILL 1 "October 2011" "procps-ng" "User Commands"
|
||||||
.SH NAME
|
.SH NAME
|
||||||
skill, snice \- send a signal or report process status
|
skill, snice \- send a signal or report process status
|
||||||
|
|
||||||
.SH SYNOPSIS
|
.SH SYNOPSIS
|
||||||
.B skill
|
.B skill
|
||||||
.RI [ "signal to send" ]
|
.RI [ signal ]
|
||||||
.RI [ options ]
|
.RI [ options ]
|
||||||
.I process selection criteria
|
.I expression
|
||||||
.br
|
.br
|
||||||
.B snice
|
.B snice
|
||||||
.RI [ "new priority" ]
|
.RI [ "new priority" ]
|
||||||
.RI [ options ]
|
.RI [ options ]
|
||||||
.I process selection criteria
|
.I expression
|
||||||
|
|
||||||
.SH DESCRIPTION
|
.SH DESCRIPTION
|
||||||
These tools are probably obsolete and unportable. The command
|
These tools are probably obsolete and unportable. The command syntax
|
||||||
syntax is poorly defined. Consider using the killall, pkill,
|
is poorly defined. Consider using the killall, pkill, and pgrep
|
||||||
and pgrep commands instead.
|
commands instead.
|
||||||
|
.PP
|
||||||
The default signal for skill is TERM. Use \-l or \-L to list available signals.
|
The default signal for skill is TERM. Use \-l or \-L to list
|
||||||
Particularly useful signals include HUP, INT, KILL, STOP, CONT, and 0.
|
available signals. Particularly useful signals include HUP, INT,
|
||||||
Alternate signals may be specified in three ways: \-9 \-SIGKILL \-KILL.
|
KILL, STOP, CONT, and 0. Alternate signals may be specified in three
|
||||||
|
ways: \-9 \-SIGKILL \-KILL.
|
||||||
The default priority for snice is +4. (snice +4 ...)
|
.PP
|
||||||
Priority numbers range from +20 (slowest) to \-20 (fastest).
|
The default priority for snice is +4. Priority numbers range from
|
||||||
Negative priority numbers are restricted to administrative users.
|
+20 (slowest) to \-20 (fastest). Negative priority numbers are
|
||||||
|
restricted to administrative users.
|
||||||
.SH "GENERAL OPTIONS"
|
.SH OPTIONS
|
||||||
.TS
|
.TP
|
||||||
lB l l.
|
.B \-f
|
||||||
\-f fast mode This is not currently useful.
|
Fast mode. This option has not been implemented.
|
||||||
\-i interactive use You will be asked to approve each action.
|
.TP
|
||||||
\-v verbose output Display information about selected processes.
|
.B \-i
|
||||||
\-w warnings enabled This is not currently useful.
|
Bnteractive move.
|
||||||
\-n no action This only displays the process ID.
|
.TP
|
||||||
\-V show version Displays version of program.
|
.B \-l
|
||||||
.TE
|
List all signal names.
|
||||||
|
.TP
|
||||||
|
.B \-L
|
||||||
|
List all signal names in a nice table.
|
||||||
|
.TP
|
||||||
|
.B \-n
|
||||||
|
No action; perform a simulation of events that would occur but do not
|
||||||
|
actually change the system.
|
||||||
|
.TP
|
||||||
|
.B \-v
|
||||||
|
Verbose; explain what is being done.
|
||||||
|
.TP
|
||||||
|
.B \-w
|
||||||
|
Enable warnings. This option has not been implemented.
|
||||||
|
.TP
|
||||||
|
.B \-V, \-\-verbose
|
||||||
|
Display version information and exit.
|
||||||
|
.PD
|
||||||
.SH "PROCESS SELECTION OPTIONS"
|
.SH "PROCESS SELECTION OPTIONS"
|
||||||
Selection criteria can be: terminal, user, pid, command.
|
Selection criteria can be: terminal, user, pid, command. The options
|
||||||
The options below may be used to ensure correct interpretation.
|
below may be used to ensure correct interpretation.
|
||||||
Do not blame Albert for this interesting interface.
|
.TP
|
||||||
.TS
|
.B \-t
|
||||||
lB l.
|
The next expression is a terminal (tty or pty).
|
||||||
\-t The next argument is a terminal (tty or pty).
|
.TP
|
||||||
\-u The next argument is a username.
|
.B \-u
|
||||||
\-p The next argument is a process ID number.
|
The next expression is a username.
|
||||||
\-c The next argument is a command name.
|
.TP
|
||||||
.TE
|
.B \-p
|
||||||
|
The next expression is a process ID number.
|
||||||
|
.TP
|
||||||
|
.B \-c
|
||||||
|
The next expression is a command name.
|
||||||
|
.PD
|
||||||
.SH SIGNALS
|
.SH SIGNALS
|
||||||
The signals listed below may be available for use with skill.
|
The behavior of signals is explained in
|
||||||
When known, numbers and default behavior are shown.
|
.BR signal (7)
|
||||||
.TS
|
manual page.
|
||||||
lB rB lB lB
|
.SH EXAMPLES
|
||||||
lfCW r l l.
|
.TP
|
||||||
Name Num Action Description
|
.B snice seti crack +7
|
||||||
0 0 n/a exit code indicates if a signal may be sent
|
Slow down seti and crack commands.
|
||||||
ALRM 14 exit
|
.TP
|
||||||
HUP 1 exit
|
.B skill \-KILL \-v /dev/pts/*
|
||||||
INT 2 exit
|
Kill users on PTY devices.
|
||||||
KILL 9 exit this signal may not be blocked
|
.TP
|
||||||
PIPE 13 exit
|
.B skill \-STOP viro lm davem
|
||||||
POLL exit
|
Stop three users.
|
||||||
PROF exit
|
.TP
|
||||||
TERM 15 exit
|
.B snice \-17 root bash
|
||||||
USR1 exit
|
Give priority to root's shell
|
||||||
USR2 exit
|
.SH "SEE ALSO"
|
||||||
VTALRM exit
|
.BR kill (1),
|
||||||
STKFLT exit may not be implemented
|
.BR kill (2),
|
||||||
PWR ignore may exit on some systems
|
.BR killall (1),
|
||||||
WINCH ignore
|
.BR nice (1),
|
||||||
CHLD ignore
|
.BR pkill (1),
|
||||||
URG ignore
|
.BR renice (1),
|
||||||
TSTP stop may interact with the shell
|
|
||||||
TTIN stop may interact with the shell
|
|
||||||
TTOU stop may interact with the shell
|
|
||||||
STOP stop this signal may not be blocked
|
|
||||||
CONT restart continue if stopped, otherwise ignore
|
|
||||||
ABRT 6 core
|
|
||||||
FPE 8 core
|
|
||||||
ILL 4 core
|
|
||||||
QUIT 3 core
|
|
||||||
SEGV 11 core
|
|
||||||
TRAP 5 core
|
|
||||||
SYS core may not be implemented
|
|
||||||
EMT core may not be implemented
|
|
||||||
BUS core core dump may fail
|
|
||||||
XCPU core core dump may fail
|
|
||||||
XFSZ core core dump may fail
|
|
||||||
.TE
|
|
||||||
|
|
||||||
.SH EXAMPLES
|
|
||||||
.TS
|
|
||||||
lB lB
|
|
||||||
lfCW l.
|
|
||||||
Command Description
|
|
||||||
snice seti crack +7 Slow down seti and crack
|
|
||||||
skill \-KILL \-v /dev/pts/* Kill users on new-style PTY devices
|
|
||||||
skill \-STOP viro lm davem Stop 3 users
|
|
||||||
snice \-17 root bash Give priority to root's shell
|
|
||||||
.TE
|
|
||||||
|
|
||||||
.SH "SEE ALSO"
|
|
||||||
.BR killall (1),
|
|
||||||
.BR pkill (1),
|
|
||||||
.BR kill (1),
|
|
||||||
.BR renice (1),
|
|
||||||
.BR nice (1),
|
|
||||||
.BR kill (2),
|
|
||||||
.BR signal (7)
|
.BR signal (7)
|
||||||
|
|
||||||
.SH STANDARDS
|
.SH STANDARDS
|
||||||
No standards apply.
|
No standards apply.
|
||||||
|
|
||||||
.SH AUTHOR
|
.SH AUTHOR
|
||||||
Albert Cahalan <albert@users.sf.net> wrote skill and snice in 1999 as a
|
.UR albert\@users.sf.net
|
||||||
replacement for a non-free version.
|
Albert Cahalan
|
||||||
|
.UE
|
||||||
Please send bug reports to <procps@freelists.org>.
|
wrote skill and snice in 1999 as a replacement for a non-free
|
||||||
|
version.
|
||||||
|
.SH "REPORTING BUGS"
|
||||||
|
Please send bug reports to
|
||||||
|
.UR procps\@freelists.org
|
||||||
|
.UE
|
||||||
|
|||||||
Loading…
Reference in New Issue
Block a user