nice(2)                                                   nice(2)



NAME
     nice - changes the priority of a process

SYNOPSIS
     int nice(incr)
     int incr;

DESCRIPTION
     nice adds the value of incr to the value of the calling
     process.  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.

STATUS MESSAGES AND VALUES
     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
     return value on successful completion (that is, if your new
     nice value is 19), errno is not changed.

     The nice program will fail if:

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

SEE ALSO
     exec(2)

     nice(1) in A/UX Command Reference




















January 1992                                                    1