procps 010114

skill.1

@@ -0,0 +1,118 @@
+,\" 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.
+.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 <acahalan@cs.uml.edu> wrote skill and snice in 1999 as a
+replacement for a non-free version. Michael K. Johnson <johnsonm@redhat.com>
+is the current maintainer of the procps collection.
+
+Please send bug reports to <acahalan@cs.uml.edu>