NICE(2)                  DOMAIN/IX SYS5                   NICE(2)



NAME
     nice - change priority of a process

USAGE
     int nice(incr)
     int incr;


DESCRIPTION
     Nice adds the value of incr to the "nice value" of the cal-
     ling process.  A process's nice value affects CPU priority;
     a higher nice value causes the process to have a lower CPU
     priority.

     The system imposes a maximum nice value of 39 and a minimum
     nice value of 0.  If you try to set the nice value to a
     level above the maximum, it will be set to 39; below the
     minimum, it will be set to 0.

RETURN VALUE
     Upon successful completion, nice returns the new nice value
     minus 20.  Otherwise, it returns -1 and sets errno to indi-
     cate the error.

ERRORS
     [EPERM]        Nice will fail and not change the nice value
                    if incr is either negative or greater than 40
                    and the effective user ID of the calling pro-
                    cess is not super-user.

RELATED INFORMATION
     exec(2), nice(1)





















Printed 12/4/86                                            NICE-1