procps/skill.1

118 lines
3.1 KiB
Groff
Raw Normal View History

2002-02-02 04:17:29 +05:30
,\" 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 \- report process status
.SH SYNOPSIS
.nf
skill [signal to send] [options] process selection criteria
snice [new priority] [options] process selection criteria
.fi
.SH DESCRIPTION
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
l l l.
-f fast mode This is not currently useful.
-i interactive use T{
You will be asked to approve each action.
T}
-v verbose output T{
Display information about selected processes.
T}
-w warnings enabled This is not currently useful.
-n no action This only displays the process ID.
-V show version Displays version of program.
2002-02-02 04:17:29 +05:30
.TE
.SH "PROCESS SELECTION OPTIONS"
Selection criteria can be: terminal, user, pid, command.
The options below may be used to ensure correct interpretation.
.TS
l 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
.TH
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
.TC
snice netscape crack +7 Slow down netscape and crack
skill -KILL -v /dev/pts/* Kill users on new-style PTY devices
skill -STOP torvalds davem tytso Stop 3 users
snice -17 root bash Give priority to root's shell
.TE
.SH "SEE ALSO"
top(1) kill(1) renice(1) nice(1)
.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, and is the current maintainer of the
procps collection. Please send bug reports to <albert@users.sf.net>