BEZEICHNUNG

       uclampset - die Utilization-Clamping-Attribute des Systems oder eines Prozesses manipulieren

ÜBERSICHT

       uclampset [Optionen] [-m uclamp_min] [-M uclamp_max] _Befehl Argument

       uclampset [Optionen] [-m uclamp_min] [-M uclamp_max] -p Prozesskennung

BESCHREIBUNG

       uclampset setzt oder ermittelt die Leistungsklammerungs-Attribute eines existierenden Prozesses mit der
       Kennung PID oder führt einen Befehl mit den angegebenen Attributen aus.

       »Utilization clamping« (Leistungsklammerung) ist eine neue Funktion, die in Version 5.3 des Kernels
       eingeführt wurde. Sie gibt dem Scheduler Hinweise zum erlaubten Bereich der »Utilization«, in dem die
       Task agieren soll.

       Die Leistung einer Task beeinflusst die Frequenzauswahl und die Platzierung der Task. Zum Zeitpunkt der
       Erstellung dieser Handbuchseite kann nur der Cpufreq-Governor »Schedutil« mit den
       Leistungsklammerungs-Hinweisen umgehen. In der Dokumentation Ihres Kernels finden Sie weitere
       Informationen über die Unterstützung anderer Cpufreq-Governors.

       Falls Sie ein asymmetrisches heterogenes System wie big.LITTLE auf der ARM-Architektur betreiben, kann
       die Leistungsklammerung dabei helfen, die Task-Platzierung auszubalancieren. Falls die Task-Leistung hoch
       ist, so dass der Wert von I höher ist als die Kapazität der kleinen Kerne, dann wird der Scheduler sein
       Bestes tun, sie in einen großen Kern zu verlagern.

       Ähnlich verhält es sich, wenn util_max kleiner oder gleich der Kapazität der kleinen Kerne ist; dann kann
       der Scheduler noch entscheiden, sie selbst dann dort zu platzieren, wenn die tatsächliche Leistung der
       Task am Maximum ist.

       Wenn Sie uclamp_min für eine Task auf einen von Null verschiedenen Wert setzen, wird die Leistung der
       Task gesteigert, so als ob sie immer von diesem Leistungswert gestartet wäre.

       Wenn Sie uclamp_max für eine Task auf einen Wert unter 1024 setzen, wird die Leistung der Task begrenzt,
       so als ob sie nie diesen Leistungswert überstiegen hätte.

       Der volle Leistungsbereich ist: [0:1024]. Der spezielle Wert -1 wird verwendet, um auf die Systemvorgabe
       zurückzusetzen.

       Weitere Details finden Sie in der neuesten Kernel-Dokumentation:

           https://kernel.org/doc/html/latest/scheduler/sched-util-clamp.html

OPTIONEN

       -m
           Legt den Wert für util_min fest.

       -M
           Legt den Wert für util_max fest.

       -a, --all-tasks
           setzt oder ermittelt die Leistungsklammerung aller Tasks (Threads) für eine gegebene Prozesskennung
           (PID).

       -p, --pid
           verwendet eine vorhandene Prozesskennung (PID), anstatt einen neuen Prozess zu starten.

       -s, --system
           setzt oder ermittelt die systemweiten Leistungsklammerungs-Attribute.

       -R, --reset-on-fork
           Setzt den Schalter SCHED_FLAG_RESET_ON_FORK.

       -v, --verbose
           zeigt Statusinformationen an.

       -h, --help
           zeigt einen Hilfetext an und beendet das Programm.

       -V, --version
           zeigt Versionsinformationen an und beendet das Programm.

VERWENDUNG

       Das Standardverhalten ist die Ausführung eines neuen Befehls:
           uclampset [-m uclamp_min] [-M uclamp_max] Befehl [Argumente]

       Sie können auch die Leistungsklammerungs-Attribute eines existierenden Prozesses ermitteln:
           uclampset -p PID

       Oder sie festlegen:
           uclampset -p Prozesskennung [-m uclamp_min] [-M uclamp_max]

       Oder die systemweiten Attribute steuern:
           uclampset -s [-m uclamp_min] [-M uclamp_max]

ZUGRIFFSRECHTE

       Ein Benutzer muss über CAP_SYS_NICE verfügen, um die Scheduling-Attribute eines Prozesses zu ändern. Die
       Ermittlung der Scheduling-Attribute ist allen Benutzern erlaubt.

ANMERKUNGEN

       Die systemweiten Leistungsklammerung-Attribute dienen der Steuerung des erlaubten Bereichs, den eine Task
       verwenden darf. Standardmäßig sind sowohl uclamp_min als auch uclamp_max auf 1024 gesetzt. Das bedeutet,
       dass Benutzer die Leistungsklammerungs-Werte für deren Tasks innerhalb des vollen Bereichs [0:1024]
       setzen können.

       Zum Beispiel:
           uclampset -s -m 512 -M 700

       hindert eine Task daran, die Leistung auf über 512 zu erhöhen. Alle Tasks in einem System sind auf eine
       Leistung von 700 begrenzt. Effektiv ergibt sich dadurch eine System-Performance von 700.

       Schauen Sie in der Kerneldokumentation nach, welches genaue Verhalten mit diesem Kernel zu erwarten wäre.

AUTOREN

       Qais Yousef <qyousef@layalina.io>

SIEHE AUCH

       nice(1), renice(1), taskset(1), sched(7)

       In sched_setscheduler(2) und sched_setattr(2) finden Sie eine Beschreibung des Scheduling-Schemas in
       Linux.

FEHLER MELDEN

       Nutzen Sie zum Melden von Fehlern das Fehlererfassungssystem auf
       https://github.com/util-linux/util-linux/issues.

VERFÜGBARKEIT

       Der Befehl uclampset ist Teil des Pakets util-linux, welches aus dem Linux-Kernel-Archiv
       <https://www.kernel.org/pub/linux/utils/util-linux/> heruntergeladen werden kann.

util-linux 2.40.2                                  2025-06-05                                       UCLAMPSET(1)