nice(2)                          DG/UX 5.4.2                         nice(2)


NAME
       nice - change priority of a process

SYNOPSIS
       #include <unistd.h>

       int  nice (incr)
       int  incr;

   where:
       incr      A positive or negative value that is to be added to the
                 calling process's priority

DESCRIPTION
       The value of incr is added to the priority of the calling process.  A
       more positive priority value results in a lower level of service from
       the CPU.

       If the new priority would be greater than 19, the process's priority
       is set to 19.  If the new priority would be less than -20, the
       process's priority is set to -20.

ACCESS CONTROL
       The effective-user-id of the calling process must be 0 (super-user)
       for nice to accept a value for incr that is less than 0 or greater
       than 39.  If this condition is not met, incr will be treated as 0,
       and errno will be set to EPERM.

RETURN VALUE
       Nice always returns the calling process's priority upon completion of
       the system call.  If an error occurred on the call, the process's
       priority will be unchanged and errno will be set to indicate the
       error.  errno should be set to zero before the call and checked
       afterwards, regardless of the return value.

DIAGNOSTICS
       EPERM     The value of incr is negative or greater than 39 and the
                 effective-user-id of the calling process is not 0.

SEE ALSO
       exec(2).
















Licensed material--property of copyright holder(s)                         1