ÜBERSICHT

#include <unistd.h>

int nice(int inc);

Mit Glibc erforderliche Makros (siehe feature_test_macros(7)):

nice(): _XOPEN_SOURCE
    || /* Seit Glibc 2.19: */ _DEFAULT_SOURCE
    || /* Glibc-Versionen <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE

BESCHREIBUNG

nice addiert inc zur Priorität des aufrufenden Prozesses (ein größerer Wert bedeutet eine niedrigere Priorität). Nur der Superuser darf ein negatives Inkrement (also eine Erhöhung der Priorität) angeben. Der Wertebereich für Prioritäten wird in getpriority(2) beschrieben.

RÜCKGABEWERT

Bei Erfolg wird der neue Wert der Priorität zurückgegeben (siehe aber ANMERKUNGEN unten). Bei einem Fehler wird -1 zurückgegeben und errno entsprechend gesetzt.

FEHLER

EPERM

Der aufrufende Prozess hat versucht, seine Priorität zu erhöhen, indem für inc eine negative Zahl übergeben wurde. Allerdings hat der Prozess dafür keine ausreichenden Privilegien. Unter Linux ist die Capability CAP_SYS_NICE erforderlich (siehe aber auch die Erläuterung der Ressourcenbeschränkung RLIMIT_NICE in setrlimit(2)).

KONFORM ZU

POSIX.1-2001, POSIX.1-2008, SVr4, 4.3BSD. Allerdings ist der Rückgabewert unter Linux und (G)libc (vorGlibc 2.2.4) nicht standardisiert, siehe unten. SVr4 dokumentiert einen zusätzlichen EINVAL-Fehlercode.

ANMERKUNGEN

SUSv2 und POSIX.1 legen fest, dass nice() den neuen Wert der Priorität zurückgeben soll. Allerdings geben der Linux-Systemaufruf und die Bibliotheksfunktion nice() in älteren Versionen der (G)libc (vor Glibc 2.2.4) bei Erfolg Null zurück. Der neue Wert der Priorität kann mittels getpriority(2) herausgefunden werden.

Seit Glibc 2.2.4 ist nice() als Bibliotheksfunktion implementiert, die getpriority(2) aufruft, um den neuen Wert der Priorität an die aufrufende Funktion zurückzugeben. Mit dieser Implementation kann ein erfolgreicher Aufruf legitim -1 zurückgeben. Um verlässlich einen Fehler zu erkennen, setzen Sie errno vor dem Aufruf auf 0 und überprüfen dessen Wert, wenn nice() -1 zurückgibt.

KOLOPHON

Diese Seite ist Teil der Veröffentlichung 4.06 des Projekts Linux-man-pages. Eine Beschreibung des Projekts, Informationen, wie Fehler gemeldet werden können sowie die aktuelle Version dieser Seite finden sich unter https://www.kernel.org/doc/man-pages/.

ÜBERSETZUNG

Die deutsche Übersetzung dieser Handbuchseite wurde von Elmar Jansen <[email protected]>, Martin Schulze <[email protected]>, Martin Eberhard Schauer <[email protected]>, Dr. Tobias Quathamer <[email protected]> und Mario Blättermann <[email protected]> erstellt.

Diese Übersetzung ist Freie Dokumentation; lesen Sie die GNU General Public License Version 3 oder neuer bezüglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG übernommen.

Wenn Sie Fehler in der Übersetzung dieser Handbuchseite finden, schicken Sie bitte eine E-Mail an <[email protected]>.