skill.1

   1 '\" t
   2 .\" (The preceding line is a note to broken versions of man to tell
   3 .\" them to pre-process this man page with tbl)
   4 .\" Man page for skill and snice.
   5 .\" Licensed under version 2 of the GNU General Public License.
   6 .\" Written by Albert Cahalan, converted to a man page by
   7 .\" Michael K. Johnson
   8 .\"
   9 .TH SKILL 1 "March 12, 1999" "Linux" "Linux User's Manual"
  10 .SH NAME
  11 skill, snice \- send a signal or report process status
  12
  13 .SH SYNOPSIS
  14 .nf
  15 skill [signal to send] [options] process selection criteria
  16 snice [new priority] [options] process selection criteria
  17 .fi
  18
  19 .SH DESCRIPTION
  20 These tools are probably obsolete and unportable. The command
  21 syntax is poorly defined. Consider using the killall, pkill,
  22 and pgrep commands instead.
  23
  24 The default signal for skill is TERM. Use -l or -L to list available signals.
  25 Particularly useful signals include HUP, INT, KILL, STOP, CONT, and 0.
  26 Alternate signals may be specified in three ways: -9 -SIGKILL -KILL.
  27
  28 The default priority for snice is +4. (snice +4 ...)
  29 Priority numbers range from +20 (slowest) to -20 (fastest).
  30 Negative priority numbers are restricted to administrative users.
  31
  32 .SH "GENERAL OPTIONS"
  33 .TS
  34 l l l.
  35 -f      fast mode       This is not currently useful.
  36 -i      interactive use T{
  37 You will be asked to approve each action.
  38 T}
  39 -v      verbose output  T{
  40 Display information about selected processes.
  41 T}
  42 -w      warnings enabled        This is not currently useful.
  43 -n      no action       This only displays the process ID.
  44 -V      show version    Displays version of program.
  45 .TE
  46
  47 .SH "PROCESS SELECTION OPTIONS"
  48 Selection criteria can be: terminal, user, pid, command.
  49 The options below may be used to ensure correct interpretation.
  50 Do not blame Albert for this interesting interface.
  51 .TS
  52 l l.
  53 -t      The next argument is a terminal (tty or pty).
  54 -u      The next argument is a username.
  55 -p      The next argument is a process ID number.
  56 -c      The next argument is a command name.
  57 .TE
  58
  59 .SH SIGNALS
  60 The signals listed below may be available for use with skill.
  61 When known, numbers and default behavior are shown.
  62 .TS
  63 lB rB lB lB
  64 lfCW r l l.
  65 Name    Num     Action  Description
  66 .TH
  67 0       0       n/a     exit code indicates if a signal may be sent
  68 ALRM    14      exit
  69 HUP     1       exit
  70 INT     2       exit
  71 KILL    9       exit    this signal may not be blocked
  72 PIPE    13      exit
  73 POLL            exit
  74 PROF            exit
  75 TERM    15      exit
  76 USR1            exit
  77 USR2            exit
  78 VTALRM          exit
  79 STKFLT          exit    may not be implemented
  80 PWR             ignore  may exit on some systems
  81 WINCH           ignore
  82 CHLD            ignore
  83 URG             ignore
  84 TSTP            stop    may interact with the shell
  85 TTIN            stop    may interact with the shell
  86 TTOU            stop    may interact with the shell
  87 STOP            stop    this signal may not be blocked
  88 CONT            restart continue if stopped, otherwise ignore
  89 ABRT    6       core
  90 FPE     8       core
  91 ILL     4       core
  92 QUIT    3       core
  93 SEGV    11      core
  94 TRAP    5       core
  95 SYS             core    may not be implemented
  96 EMT             core    may not be implemented
  97 BUS             core    core dump may fail
  98 XCPU            core    core dump may fail
  99 XFSZ            core    core dump may fail
 100 .TE
 101
 102 .SH EXAMPLES
 103 .TS
 104 lB lB
 105 lfCW l.
 106 Command Description
 107 .TC
 108 snice seti crack +7     Slow down seti and crack
 109 skill -KILL -v /dev/pts/*       Kill users on new-style PTY devices
 110 skill -STOP viro lm davem       Stop 3 users
 111 snice -17 root bash     Give priority to root's shell
 112 .TE
 113
 114 .SH "SEE ALSO"
 115 killall(1) pkill(1) kill(1) renice(1) nice(1) signal(7) kill(2)
 116
 117 .SH STANDARDS
 118 No standards apply.
 119
 120 .SH AUTHOR
 121 Albert Cahalan <albert@users.sf.net> wrote skill and snice in 1999 as a
 122 replacement for a non-free version, and is the current maintainer of the
 123 procps collection. Please send bug reports to <procps-feedback@lists.sf.net>.