NAME

nice - change process priority

SYNOPSIS

#include <unistd.h> int nice(int inc);

DESCRIPTION

nice(2) adds inc to the nice value for the calling pid. (A large nice value means a low priority.) Only the super- user may specify a negative increment, or priority increase.

RETURN VALUE

On success, the new nice variable is returned. On failure -1 is returned. Since -1 is a valid return for nice(2), set errno(3) to 0 before calling nice(2), and check its value afterwards if nice(2) returns a value of -1.

ERRORS

EPERM

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

CONFORMING TO

SVr4, SVID EXT, AT

NOTES

Older (g)libc (earlier than glibc 2.2.4) return 0 on success, and the new nice value should be found by calling getpriority(2).

SEE ALSO

nice(1), getpriority(2), setpriority(2), fork(2), renice(1), sched_getscheduler(2), sched_getparam(2)