Differences between version 5 and revision by previous author of nice(2).
Other diffs: Previous Major Revision, Previous Revision, or view the Annotated Edit History
Newer page: | version 5 | Last edited on Monday, June 6, 2005 12:37:32 pm | by PerryLorier | Revert |
Older page: | version 1 | Last edited on Tuesday, June 4, 2002 12:23:43 am | by perry | Revert |
@@ -1,64 +1,25 @@
-NICE
-!!!NICE
-NAME
-SYNOPSIS
-DESCRIPTION
-RETURN VALUE
-ERRORS
-CONFORMING TO
-NOTES
-SEE ALSO
-----
!!NAME
+nice - change process priority
-
-nice - change process priority
!!SYNOPSIS
+ __#include <unistd.h>__
+ __int nice(int__ ''inc''__);__
-
-__#include __
-
-
-__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.
-
-__nice__ 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 to 0 before calling nice(3), and check it's value afterwards.
-
-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 by supplying a negative ''inc''.
-
-__EPERM__
-
-
-A non-super user attempts to do a priority increase by
-supplying a negative ''inc''.
!!CONFORMING TO
+SVr4, SVID EXT, AT
-
-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).
-
-Note that the routine is documented in SUSv2 to return the
-new nice value, while the Linux syscall and (g)libc (earlier
-than glibc 2.2.4) routines return 0 on success. The new nice
-value can be found using getpriority(2). Note that an
-implementation in which __nice__ returns the new nice
-value can legitimately return -1. To reliably detect an
-error, set ''errno'' to 0 before the call, and check its
-value when __nice__ returns -1.
!!SEE ALSO
-
-
-
nice(1), getpriority(2),
-
setpriority(2), fork(2),
-
renice(8
)
-----
+nice(1), getpriority(2), setpriority(2), fork(2), renice(1), sched_getscheduler(2), sched_getparam(2
)