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