int nice(int incr);
A request was made to change the nice value to a lower numeric value and the current process does not have appropriate privilege.
UNIX 98, with exceptions.
UNIX 98 documentation refers to NZERO as the default nice value, and then states that the value parameter is interpreted as (value + NZERO). This is confusing, and somewhat contradictory with standard UNIX behavior. The NuTCRACKER Platform implementation uses values of -NZERO to NZERO-1, which is the same thing. NZERO is defined as 20 in <limits.h>.
The NuTCRACKER Platform does not restrict a process from lowering its nice value (that is, raising its priority), as most UNIX platforms do. This is in keeping with the way the underlying Win32 APIs are implemented.
The following table shows the
mapping between nice values and Win32 priorities. Refer to the
Win32 documentation for
|nice value||Win32 Priority|
|-20 to -16||THREAD_PRIORITY_HIGHEST|
|-15 to -6||THREAD_PRIORITY_ABOVE_NORMAL|
|-5 to +4||THREAD_PRIORITY_NORMAL|
|+5 to +14||THREAD_PRIORITY_BELOW_NORMAL|
|+15 to +19||THREAD_PRIORITY_LOWEST|
This API results in a call to the Windows function
Do not adjust the Windows Priority Class with the Windows
SetPriorityClass()API. This can cause NuTCRACKER Platform core data structures to become corrupt and unusable or other undesirable results; all of which could result in the system hanging or worse.
PTC MKS Toolkit for Professional Developers
PTC MKS Toolkit for Professional Developers 64-Bit Edition
PTC MKS Toolkit for Enterprise Developers
PTC MKS Toolkit for Enterprise Developers 64-Bit Edition
execl(), execle(), execlp(), execlpe(), execv(), execve(), execvp(), execvpe(), fork(), getpriority(), setpriority()
PTC MKS Toolkit 10.3 Documentation Build 39.