nice(2)                                                   nice(2)



     NAME
          nice - change priority of a process

     SYNOPSIS
          int nice(incr)
          int incr;

     DESCRIPTION
          nice adds the value of incr to the value of the calling pro-
          cess.  A process's nice value is a positive number for which
          a higher value results in lower CPU priority.

          A maximum nice value of 39 and a minimum nice value of 0 are
          imposed by the system.  Requests for values above or below
          these limits result in the nice value being set to the
          corresponding limit.

     RETURN VALUE
          Upon successful completion, nice returns the new nice value
          minus 20.  Otherwise, a value of -1 is returned and errno is
          set to indicate the error.  If a value of -1 is a valid re-
          turn value on successful completion (i.e., if your new nice
          value is 19), errno is not changed.

     ERRORS
          nice will fail if:

          [EPERM]      nice will fail and not change the nice value if
                       incr is negative or greater than 40 and the ef-
                       fective user ID of the calling process is not
                       superuser.

     SEE ALSO
          nice(1), exec(2).





















     April, 1990                                                     1