procps/skill.1
Sami Kerola 71d10d3a49 name change: procps -> procps-ng
Signed-off-by: Sami Kerola <kerolasa@iki.fi>
2011-06-04 20:50:12 +02:00

130 lines
3.4 KiB
Groff

'\" t
.\" (The preceding line is a note to broken versions of man to tell
.\" them to pre-process this man page with tbl)
.\" Man page for skill and snice.
.\" Licensed under version 2 of the GNU General Public License.
.\" Written by Albert Cahalan, converted to a man page by
.\" Michael K. Johnson
.\"
.TH SKILL 1 "March 12, 1999" "Linux" "Linux User's Manual"
.SH NAME
skill, snice \- send a signal or report process status
.SH SYNOPSIS
.B skill
.RI [ "signal to send" ]
.RI [ options ]
.I process selection criteria
.br
.B snice
.RI [ "new priority" ]
.RI [ options ]
.I process selection criteria
.SH DESCRIPTION
These tools are probably obsolete and unportable. The command
syntax is poorly defined. Consider using the killall, pkill,
and pgrep commands instead.
The default signal for skill is TERM. Use \-l or \-L to list available signals.
Particularly useful signals include HUP, INT, 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 ...)
Priority numbers range from +20 (slowest) to \-20 (fastest).
Negative priority numbers are restricted to administrative users.
.SH "GENERAL OPTIONS"
.TS
lB l l.
\-f fast mode This is not currently useful.
\-i interactive use You will be asked to approve each action.
\-v verbose output Display information about selected processes.
\-w warnings enabled This is not currently useful.
\-n no action This only displays the process ID.
\-V show version Displays version of program.
.TE
.SH "PROCESS SELECTION OPTIONS"
Selection criteria can be: terminal, user, pid, command.
The options below may be used to ensure correct interpretation.
Do not blame Albert for this interesting interface.
.TS
lB l.
\-t The next argument is a terminal (tty or pty).
\-u The next argument is a username.
\-p The next argument is a process ID number.
\-c The next argument is a command name.
.TE
.SH SIGNALS
The signals listed below may be available for use with skill.
When known, numbers and default behavior are shown.
.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 this signal may not be blocked
PIPE 13 exit
POLL exit
PROF exit
TERM 15 exit
USR1 exit
USR2 exit
VTALRM exit
STKFLT exit may not be implemented
PWR ignore may exit on some systems
WINCH ignore
CHLD ignore
URG ignore
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)
.SH STANDARDS
No standards apply.
.SH AUTHOR
Albert Cahalan <albert@users.sf.net> wrote skill and snice in 1999 as a
replacement for a non-free version.
Please send bug reports to <procps@freelists.org>.