nice

NAME

       nice - change process priority

SYNOPSIS

       #include <unistd.h>

       int nice(int inc);

DESCRIPTION

       nice  adds  inc to the priority for the calling pid.  Note
       that only the superuser may specify a negative  increment,
       or priority increase.  Note that internally, a higher num-
       ber is a higher priority.  Do not confuse  this  with  the
       priority scheme as used by the nice interface.

RETURN VALUE

       On  success,  zero is returned.  On error, -1 is returned,
       and errno is set appropriately.

ERRORS

       EPERM   A  non-super  user  attempts  to  do  a   priority
               increase,  a  numerical  decrease,  by supplying a
               negative inc.

CONFORMING TO

       SVID EXT, AT&T, X/OPEN, BSD 4.3

SEE ALSO

       nice(1), setpriority(2), fork(2), renice(8)