nice(1)




NAME

     nice - invoke a command with an altered scheduling priority


SYNOPSIS

     /usr/bin/nice [-increment |  -n increment]   command  [argu-
     ment...]

     /usr/xpg4/bin/nice  [-increment  |  -n increment]    command
     [argument...]

  csh Builtin
     nice [-increment | +increment]  [command]


DESCRIPTION

     The nice utility invokes command, requesting that it be  run
     with a different system scheduling priority. The priocntl(1)
     command is a more general interface to scheduler functions.

     The invoking process (generally the user's shell) must be in
     a scheduling class that supports nice.

     If the C shell (see csh(1)) is used, the full  path  of  the
     command  must be specified; otherwise, the csh built-in ver-
     sion of nice will be invoked. See csh Builtin below.

  /usr/bin/nice
     If nice  executes  commands  with  arguments,  it  uses  the
     default shell /usr/bin/sh (see sh(1)).

  /usr/xpg4/bin/nice
     If  nice  executes  commands   with   arguments,   it   uses
     /usr/xpg4/bin/sh (see ksh(1)).

  csh Builtin
     nice is also a csh built-in command with behavior  different
     from the utility versions.  See csh(1) for description.


OPTIONS

     The following options are supported:

     -increment | -n increment
           increment must be in the range 1-19; if not specified,
           an  increment  of  10 is assumed. An increment greater
           than 19 is equivalent to 19.

           The super-user may run commands with  priority  higher
           than normal by using a negative increment such as -10.
           A negative increment assigned by an unprivileged  user
           is ignored.


OPERANDS


     The following operands are supported:

     command
           The name of a command that is to be invoked.  If  com-
           mand  names any of the special built-in utilities (see
           shell_builtins(1)), the results are undefined.

     argument
           Any string to be supplied as an argument when invoking
           command.


ENVIRONMENT VARIABLES

     See environ(5) for descriptions of the following environment
     variables  that  affect the execution of nice: LANG, LC_ALL,
     LC_CTYPE, LC_MESSAGES, PATH, and NLSPATH.


EXIT STATUS

     If command is invoked, the exit status of nice will  be  the
     exit  status  of command. Otherwise, nice will exit with one
     of the following values:

     1-125 An error occurred.

     126   command was found but could not be invoked.

     127   command could not be found.


ATTRIBUTES

     See attributes(5) for descriptions of the  following  attri-
     butes:

  /usr/bin/nice
     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWcsu                     |
    |_____________________________|_____________________________|
    | CSI                         | enabled                     |
    |_____________________________|_____________________________|

  /usr/xpg4/bin/nice
     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWxcu4                    |
    |_____________________________|_____________________________|
    | CSI                         | enabled                     |
    |_____________________________|_____________________________|
    | Interface Stability         | Standard                    |
    |_____________________________|_____________________________|


SEE ALSO

     csh(1),    ksh(1),     nohup(1),     priocntl(1),     sh(1),
     shell_builtins(1), nice(2), attributes(5), environ(5), stan-
     dards(5)


Man(1) output converted with man2html