sched_setparam(2)

BEZEICHNUNG
sched_setparam, sched_getparam - Scheduling-Parameter setzen und erhalten

BIBLIOTHEK
Standard-C-Bibliothek (libc, -lc)

ÜBERSICHT
#include <sched.h>

int sched_setparam(pid_t pid, const struct sched_param *param);
int sched_getparam(pid_t pid, struct sched_param *param);

struct sched_param {
    …
    int sched_priority;
    …
};

BESCHREIBUNG
sched_setparam() setzt die der Scheduling-Richtlinie zugeordneten Scheduling-Parameter für den Thread, dessen Kennung in pid angegeben ist. Falls pid Null ist, dann werden die Parameter des aufrufenden Threads gesetzt. Die Interpretation des Parameters param hängt von der Scheduling-Richtlinie des mittels pid identifizierten Threads ab. Siehe sched(7) für eine Beschreibung der von Linux unterstützten Scheduling-Richtlinien.

sched_getparam() ermittelt die Scheduling-Parameter für den durch pid identifizierten Thread. Falls pid Null ist, dann werden die Parameter für den aufrufenden Thread ermittelt.

sched_setparam() prüft die Gültigkeit von param für die Scheduling-Richtlinie des Threads. Der Wert param->sched_priority muss in dem durch sched_get_priority_min(2) und sched_get_priority_max(2) angegebenen Bereich liegen.

Für eine Diskussion der Privilegien und Ressourcenbeschränkungen im Zusammenhang mit der Scheduling-Priorität und -Richtlinie siehe sched(7).

Auf POSIX-Systemen, auf denen sched_setparam() und sched_getparam() verfügbar sind, ist _POSIX_PRIORITY_SCHEDULING in <unistd.h> definiert.

RÜCKGABEWERT
Im Erfolgsfall liefern sched_setparam() und sched_getparam() 0 zurück. Im Fehlerfall wird -1 zurückgeliefert und errno gesetzt, um den Fehler anzuzeigen.

FEHLER

EINVAL
    Ungültige Argumente: param ist NULL oder pid ist negativ.

EINVAL
    (sched_setparam()) Das Argument param ergibt für die aktuelle Scheduling-Richtlinie keinen Sinn.

EPERM
    (sched_setparam()) Der Aufrufende verfügt nicht über die geeigneten Privilegien (Linux: hat die Capability CAP_SYS_NICE nicht).

ESRCH
    Der Thread mit der Kennung PID konnte nicht gefunden werden.

STANDARDS
POSIX.1-2024.

GESCHICHTE
POSIX.1-2001.

SIEHE AUCH
getpriority(2), gettid(2), nice(2), sched_get_priority_max(2), sched_get_priority_min(2), sched_getaffinity(2), sched_getscheduler(2), sched_setaffinity(2), sched_setattr(2), sched_setscheduler(2), setpriority(2), capabilities(7), sched(7)

ÜBERSETZUNG
Die deutsche Übersetzung dieser Handbuchseite wurde von Helge Kreutzmann <debian@helgefjell.de> erstellt.

Diese Übersetzung ist Freie Dokumentation; lesen Sie die GNU General Public License Version 3 (https://www.gnu.org/licenses/gpl-3.0.html) 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 die Mailingliste der Übersetzer: debian-l10n-german@lists.debian.org.