skill.1 2.88 KB
Newer Older
albert's avatar
albert committed
1
'\" t
csmall's avatar
csmall committed
2 3 4 5 6 7 8
.\" (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
.\"
9
.TH SKILL 1 "October 2011" "procps-ng" "User Commands"
csmall's avatar
csmall committed
10
.SH NAME
albert's avatar
albert committed
11
skill, snice \- send a signal or report process status
csmall's avatar
csmall committed
12
.SH SYNOPSIS
Jan Görig's avatar
Jan Görig committed
13
.B skill
14
.RI [ signal ]
Jan Görig's avatar
Jan Görig committed
15
.RI [ options ]
16
.I expression
Jan Görig's avatar
Jan Görig committed
17 18 19 20
.br
.B snice
.RI [ "new priority" ]
.RI [ options ]
21
.I expression
csmall's avatar
csmall committed
22
.SH DESCRIPTION
23 24
These tools are obsolete and unportable.  The command syntax is
poorly defined.  Consider using the killall, pkill, and pgrep
25 26 27 28 29 30 31 32 33 34 35 36
commands instead.
.PP
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.
.PP
The default priority for snice is +4.  Priority numbers range from
+20 (slowest) to \-20 (fastest).  Negative priority numbers are
restricted to administrative users.
.SH OPTIONS
.TP
37
.BR \-f , \ \-\-fast
38 39
Fast mode.  This option has not been implemented.
.TP
40 41
.BR \-i , \ \-\-interactive
Interactive use.  You will be asked to approve each action.
42
.TP
43
.BR \-l , \ \-\-list
44 45
List all signal names.
.TP
46
.BR \-L , \ \-\-table
47 48
List all signal names in a nice table.
.TP
49
.BR \-n , \ \-\-no\-action
50 51 52
No action; perform a simulation of events that would occur but do not
actually change the system.
.TP
53
.BR \-v , \ \-\-verbose
54 55
Verbose; explain what is being done.
.TP
56
.BR \-w , \ \-\-warnings
57 58
Enable warnings.  This option has not been implemented.
.TP
59 60 61 62 63
\fB\-h\fR, \fB\-\-help\fR
Display help text and exit.
.TP
\fB\-V\fR, \fB\-\-version\fR
Display version information.
64
.PD
csmall's avatar
csmall committed
65
.SH "PROCESS SELECTION OPTIONS"
66 67 68
Selection criteria can be: terminal, user, pid, command.  The options
below may be used to ensure correct interpretation.
.TP
69
\fB\-t\fR, \fB\-\-tty\fR \fItty\fR
70 71
The next expression is a terminal (tty or pty).
.TP
72
\fB\-u\fR, \fB\-\-user\fR \fIuser\fR
73 74
The next expression is a username.
.TP
75
\fB\-p\fR, \fB\-\-pid\fR \fIpid\fR
76 77
The next expression is a process ID number.
.TP
78
\fB\-c\fR, \fB\-\-command\fR \fIcommand\fR
79 80
The next expression is a command name.
.PD
csmall's avatar
csmall committed
81
.SH SIGNALS
82 83 84
The behavior of signals is explained in
.BR signal (7)
manual page.
csmall's avatar
csmall committed
85
.SH EXAMPLES
86
.TP
87
.B snice -c seti -c crack +7
88 89
Slow down seti and crack commands.
.TP
90
.B skill \-KILL \-t /dev/pts/*
91 92
Kill users on PTY devices.
.TP
93
.B skill \-STOP \-u viro \-u lm \-u davem
94
Stop three users.
csmall's avatar
csmall committed
95
.SH "SEE ALSO"
96 97
.BR kill (1),
.BR kill (2),
Jan Görig's avatar
Jan Görig committed
98
.BR killall (1),
99
.BR nice (1),
Jan Görig's avatar
Jan Görig committed
100 101 102
.BR pkill (1),
.BR renice (1),
.BR signal (7)
csmall's avatar
csmall committed
103 104 105
.SH STANDARDS
No standards apply.
.SH AUTHOR
106 107 108 109 110 111 112 113 114
.UR albert\@users.sf.net
Albert Cahalan
.UE
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