'\" t
.\"     Title: uclampset
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.20
.\"      Date: 2024-04-27
.\"    Manual: Dienstprogramme für Benutzer
.\"    Source: util-linux 2.40
.\"  Language: English
.\"
.TH "UCLAMPSET" "1" "2024-04-27" "util\-linux 2.40" "Dienstprogramme für Benutzer"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if \n[.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE blue R < >
.\}
.SH "BEZEICHNUNG"
uclampset \- die Utilization\-Clamping\-Attribute des Systems oder eines Prozesses manipulieren
.SH "ÜBERSICHT"
.sp
\fBuclampset\fP [options] [\fB\-m\fP \fIuclamp_min\fP] [\fB\-M\fP \fIuclamp_max] _command argument\fP
.sp
\fBuclampset\fP [options] [\fB\-m\fP \fIuclamp_min\fP] [\fB\-M\fP \fIuclamp_max\fP] \fB\-p\fP \fIPID\fP
.SH "BESCHREIBUNG"
.sp
\fBuclampset\fP sets or retrieves the utilization clamping attributes of an existing \fIPID\fP, or runs \fIcommand\fP with the given attributes.
.sp
»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.
.sp
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.
.sp
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.
.sp
Ähnlich verhält es sich, wenn \fIutil_max\fP 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.
.sp
Wenn Sie \fIuclamp_min\fP 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.
.sp
Wenn Sie \fIuclamp_max\fP 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.
.sp
Der volle Leistungsbereich ist: [0:1024]. Der spezielle Wert \-1 wird verwendet, um auf die Systemvorgabe zurückzusetzen.
.sp
Weitere Details finden Sie in der neuesten Kernel\-Dokumentation:
.sp
.if n .RS 4
.nf
.fam C
https://kernel.org/doc/html/latest/scheduler/sched\-util\-clamp.html
.fam
.fi
.if n .RE
.SH "OPTIONEN"
.sp
\fB\-m\fP
.RS 4
Legt den Wert für \fIutil_min\fP fest.
.RE
.sp
\fB\-M\fP
.RS 4
Legt den Wert für \fIutil_max\fP fest.
.RE
.sp
\fB\-a\fP, \fB\-\-all\-tasks\fP
.RS 4
setzt oder ermittelt die Leistungsklammerung aller Tasks (Threads) für eine gegebene Prozesskennung (PID).
.RE
.sp
\fB\-p\fP, \fB\-\-pid\fP
.RS 4
verwendet eine vorhandene Prozesskennung (PID), anstatt einen neuen Prozess zu starten.
.RE
.sp
\fB\-s\fP, \fB\-\-system\fP
.RS 4
setzt oder ermittelt die systemweiten Leistungsklammerungs\-Attribute.
.RE
.sp
\fB\-R\fP, \fB\-\-reset\-on\-fork\fP
.RS 4
Setzt den Schalter \fBSCHED_FLAG_RESET_ON_FORK\fP.
.RE
.sp
\fB\-v\fP, \fB\-\-verbose\fP
.RS 4
zeigt Statusinformationen an.
.RE
.sp
\fB\-h\fP, \fB\-\-help\fP
.RS 4
zeigt einen Hilfetext an und beendet das Programm.
.RE
.sp
\fB\-V\fP, \fB\-\-version\fP
.RS 4
zeigt Versionsinformationen an und beendet das Programm.
.RE
.SH "VERWENDUNG"
.sp
Das Standardverhalten ist die Ausführung eines neuen Befehls:
.RS 4
\fBuclampset\fP \fI[\-m uclamp_min]\fP \fI[\-M uclamp_max]\fP \fIcommand\fP [\fIarguments\fP]
.RE
.sp
Sie können auch die Leistungsklammerungs\-Attribute eines existierenden Prozesses ermitteln:
.RS 4
\fBuclampset \-p\fP \fIPID\fP
.RE
.sp
Oder sie festlegen:
.RS 4
\fBuclampset \-p\fP \fIPID\fP \fI[\-m uclamp_min]\fP \fI[\-M uclamp_max]\fP
.RE
.sp
Oder die systemweiten Attribute steuern:
.RS 4
\fBuclampset \-s\fP \fI[\-m uclamp_min]\fP \fI[\-M uclamp_max]\fP
.RE
.SH "ZUGRIFFSRECHTE"
.sp
Ein Benutzer muss über \fBCAP_SYS_NICE\fP verfügen, um die Scheduling\-Attribute eines Prozesses zu ändern. Die Ermittlung der Scheduling\-Attribute ist allen Benutzern erlaubt.
.SH "ANMERKUNGEN"
.sp
Die systemweiten Leistungsklammerung\-Attribute dienen der Steuerung des \fIerlaubten Bereichs\fP, den eine Task verwenden darf. Standardmäßig sind sowohl \fIuclamp_min\fP als auch \fIuclamp_max\fP auf 1024 gesetzt. Das bedeutet, dass Benutzer die Leistungsklammerungs\-Werte für deren Tasks innerhalb des vollen Bereichs [0:1024] setzen können.
.sp
Zum Beispiel:
.RS 4
\fBuclampset \-s\fP \f(CR\-m 512\fP \f(CR\-M 700\fP
.RE
.sp
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.
.sp
Schauen Sie in der Kerneldokumentation nach, welches genaue Verhalten mit diesem Kernel zu erwarten wäre.
.SH "AUTOREN"
.sp
.MTO "qyousef\(atlayalina.io" "Qais Yousef" ""
.SH "SIEHE AUCH"
.sp
\fBnice\fP(1),
\fBrenice\fP(1),
\fBtaskset\fP(1),
\fBsched\fP(7)
.sp
In \fBsched_setscheduler\fP(2) und \fBsched_setattr\fP(2) finden Sie eine Beschreibung des Scheduling\-Schemas in Linux.
.SH "FEHLER MELDEN"
.sp
Nutzen Sie zum Melden von Fehlern das Fehlererfassungssystem auf \c
.URL "https://github.com/util\-linux/util\-linux/issues" "" "."
.SH "VERFÜGBARKEIT"
.sp
Der Befehl \fBuclampset\fP ist Teil des Pakets util\-linux, welches aus dem \c
.URL "https://www.kernel.org/pub/linux/utils/util\-linux/" "Linux\-Kernel\-Archiv" ""
heruntergeladen werden kann.