nice(2) — sys5



NICE(2)         DOMAIN/IX Reference Manual (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
     calling process.  A process's nice value affects CPU prior-
     ity; 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 5/10/85                                            NICE-1
Museum
