ОБЗОР
#include <unistd.h>int nice(int inc);
Требования макроса тестирования свойств для glibc (см. feature_test_macros(7)):
nice(): _BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE
ОПИСАНИЕ
nice() добавляет значение аргумента inc к значению относительного приоритета (nice) вызывающего процесса (большее значение nice означает меньший приоритет). Только суперпользователь может задавать отрицательные значения или определять увеличение приоритета. Диапазон значений nice описан в getpriority(2).ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ
При успешном выполнении возвращается новое значение nice (но см. ЗАМЕЧАНИЯ далее). В случае ошибки возвращается -1, а errno устанавливается в соответствующее значение.ОШИБКИ
- EPERM
- Вызывающий процесс пытается увеличить свой приоритет, указав отрицательное значение inc, но не имеет для этого прав. В Linux для этого требуется мандат CAP_SYS_NICE (но смотрите обсуждение ограничение ресурса RLIMIT_NICE в setrlimit(2)).
СООТВЕТСТВИЕ СТАНДАРТАМ
POSIX.1-2001, POSIX.1-2008, SVr4, 4.3BSD. Однако, в Linux и (g)libc (до glibc 2.2.4) возвращалось нестандартное значение, см. далее. В SVr4 описан дополнительный код ошибки EINVAL.ЗАМЕЧАНИЯ
В SUSv2 и POSIX.1 указано, что nice() должен возвращать новое значение nice. Однако, системный вызов Linux и библиотечная функция nice() в старых версиях (g)libc (до glibc 2.2.4) возвращают 0 при успешном выполнении. Новое значение nice можно определить с помощью getpriority(2).Начиная с glibc 2.2.4, nice() реализован как библиотечная функция, которая вызывает getpriority(2) для получения нового значения nice для возврата. В этой реализации успешное выполнение может законно вернуть -1. Для надёжного обнаружения ошибки, установите переменную errno в 0 перед вызовом и проверьте её значение, если nice() вернёт -1.