manual/gnumaniak/original/man1/nice.1

   1 .\" You may copy, distribute and modify under the terms of the LDP General
   2 .\" Public License as specified in the LICENSE file that comes with the
   3 .\" gnumaniak distribution
   4 .\"
   5 .\" The author kindly requests that no comments regarding the "better"
   6 .\" suitability or up-to-date notices of any info documentation alternative
   7 .\" is added without contacting him first.
   8 .\"
   9 .\" (C) 1999-2002 Ragnar Hojland Espinosa <ragnar@ragnar-hojland.com>
  10 .\"
  11 .\"     GNU nice man page
  12 .\"     man pages are NOT obsolete!
  13 .\"     <ragnar@ragnar-hojland.com>
  14 .TH nice 1 "18 June 2002" "GNU Shell Utilities 2.1"
  15 .SH NAME
  16 nice \- run a program with modified scheduling priority
  17 .SH SYNOPSIS
  18 .B nice
  19 .BI "[\-n " adjustment "] [\-" adjustment "] [\-\-adjustment=" adjustment ]
  20 .BI [ command " [" arg... ]]
  21 .sp
  22 .B nice [\-\-help] [\-\-version]
  23 .SH DESCRIPTION
  24 .B nice
  25 prints the current scheduling priority, which it inherited if no
  26 arguments are given.
  27 Otherwise,
  28 .B nice
  29 runs the given
  30 .I command
  31 with its scheduling priority adjusted.
  32 .P
  33 If no
  34 .I adjustment
  35 is given, the priority of the
  36 .I command
  37 is incremented by 10.  The priority can be
  38 adjusted by
  39 .B nice
  40 over the range of -20 (the highest priority) to 19 (the lowest). You must
  41 have appropiate privileges to specify a negative adjustment (usually be
  42 the super-user).
  43 .P
  44 Because most shells have a built-in command by the same name, using
  45 the unadorned command name may get you different functionality than that
  46 described here.
  47 .SH OPTIONS
  48 .TP
  49 .BI "\-n " adjustment ", \-" adjustment ", \-\-adjustment=" adjustment
  50 Add
  51 .I adjustment
  52 instead of 10 to the
  53 .IR command 's
  54 priority.
  55 .TP
  56 .B "\-\-help"
  57 Print a usage message on standard output and exit successfully.
  58 .TP
  59 .B "\-\-version"
  60 Print version information on standard output then exit successfully.
  61 .SH NOTES
  62 Report bugs to bug-sh-utils@gnu.org.
  63 Page updated by Ragnar Hojland Espinosa <ragnar@ragnar-hojland.com>