nice() - Unix 和 Linux 系統呼叫

名稱

nice - 更改程序優先順序

語法

#include <unistd.h>

int nice(int inc);

描述

nice() 將inc新增到呼叫程序的 nice 值。（較高的 nice 值表示較低的優先順序。）只有超級使用者才能指定負增量或優先順序提升。nice 值的範圍在getpriority(2) 中進行了描述。

返回值

成功時，返回新的 nice 值（但請參見下面的註釋）。錯誤時，返回 -1，並且errno被相應地設定。

錯誤

標籤	描述
EPERM	呼叫程序嘗試透過提供負inc來提高其優先順序，但許可權不足。在 Linux 下，需要CAP_SYS_NICE 功能。（但請參見setrlimit(2) 中RLIMIT_NICE 資源限制的討論。）

符合標準

SVr4、4.3BSD、POSIX.1-2001。但是，Linux 和 (g)libc（早於 glibc 2.2.4）的返回值是非標準的，請參見下文。SVr4 文件中記錄了額外的 EINVAL 錯誤程式碼。

註釋

SUSv2 和 POSIX.1-2001 指定nice() 應該返回新的 nice 值。但是，Linux 系統呼叫和 (g)libc（早於 glibc 2.2.4）的舊版本中提供的nice() 庫函式在成功時返回 0。可以使用getpriority(2) 找到新的 nice 值。

從 glibc 2.2.4 開始，nice() 實現為一個庫函式，它呼叫getpriority(2) 以獲取要返回給呼叫者的新的 nice 值。使用此實現，成功的呼叫可以合法地返回 -1。要可靠地檢測錯誤，在呼叫之前將errno設定為 0，並在nice() 返回 -1 時檢查其值。

參見

列印頁面