NICE(2)             UNIX Programmer's Manual              NICE(2)

NAME
     nice - change program priority

SYNOPSIS
     nice(incr)

DESCRIPTION
     The scheduling priority of the process is augmented by _i_n_c_r.
     Positive priorities get less service than normal.  Priority
     10 is recommended to users who wish to execute long-running
     programs without flak from the administration.

     Negative increments are ignored except on behalf of the
     super-user.  The priority is limited to the range -20 (most
     urgent) to 20 (least).

     The priority of a process is passed to a child process by
     _f_o_r_k(2).  For a privileged process to return to normal
     priority from an unknown state, _n_i_c_e should be called suc-
     cessively with arguments -40 (goes to priority -20 because
     of truncation), 20 (to get to 0), then 0 (to maintain compa-
     tibility with previous versions of this call).

ERRORS
     _N_i_c_e will fail and the process's scheduling priority remain
     the same if:

     [EPERM]             _I_n_c_r is negative and the process's
                         effective user ID is not the super-user.

SEE ALSO
     nice(1), renice(1), renice(2)

ASSEMBLER
     (nice = 34.)
     (priority in r0)
     sys nice

Printed 5/21/83                                                 1