nice

 

---

 
 
 
 User Commands                                             nice(1)
 
 
 


NAME
      nice - invoke a command with an altered scheduling priority
 


SYNOPSIS
      /usr/bin/nice [ -increment  |  -n increment  ]   command   [
      argument ... ]
 
      /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,  which  is equivalent to /usr/bin/ksh (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.
 
 
 
 
 
 SunOS 5.8           Last change: 18 Mar 1997                    1
 
 
 
 
 
 
 User Commands                                             nice(1)
 
 
 


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: 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                     |
     |_____________________________|_____________________________|
 
 


SEE ALSO
      csh(1),    ksh(1),     nohup(1),     priocntl(1),     sh(1),
      shell_builtins(1),   nice(2),   attributes(5),   environ(5),
      XPG4(5)
 
 
 
 SunOS 5.8           Last change: 18 Mar 1997                    2
 
 
 

---