Differences between version 2 and predecessor to the previous major change of nice(2).
Other diffs: Previous Revision, Previous Author, or view the Annotated Edit History
Newer page: | version 2 | Last edited on Sunday, March 16, 2003 5:53:48 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,26 @@
-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, zero is returned. On error, -1 is returned, and ''errno'' is set appropriately.
-
-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
+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.
-
-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(8)