'\" t
.\"     Title: uclampset
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.20
.\"      Date: 2024-01-05
.\"    Manual: Команди користувача
.\"    Source: util-linux 2.39.3
.\"  Language: English
.\"
.TH "UCLAMPSET" "1" "2024-01-05" "util\-linux 2.39.3" "Команди користувача"
.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 "НАЗВА"
uclampset \- керування атрибутами обмеження використання системи або процесу
.SH "КОРОТКИЙ ОПИС"
.sp
\fBuclampset\fP [параметр] [\fB\-m\fP \fIuclamp_min\fP] [\fB\-M\fP \fIuclamp_max] _аргумент команди\fP
.sp
\fBuclampset\fP [параметри] [\fB\-m\fP \fIuclamp_min\fP] [\fB\-M\fP \fIuclamp_max\fP] \fB\-p\fP \fIPID\fP
.SH "ОПИС"
.sp
\fBuclampset\fP встановлює або отримує атрибути обмеження використання наявного \fIPID\fP або запускає \fIкоманду\fP із заданими атрибутами.
.sp
Utilization clamping is a new feature added in v5.3. It gives a hint to the scheduler about the allowed range of utilization the task should be operating at.
.sp
The utilization of the task affects frequency selection and task placement. Only schedutil cpufreq governor understands handling util clamp hints at the time of writing. Consult your kernel docs for further info about other cpufreq governors support.
.sp
If you\(cqre running on asymmetric heterogeneous system like Arm\(cqs big.LITTLE. Utilization clamping can help bias task placement. If the task is boosted such that \fIutil_min\fP value is higher than the little cores\*(Aq capacity, then the scheduler will do its best to place it on a big core.
.sp
Similarly, if \fIutil_max\fP is smaller than or equal the capacity of the little cores, then the scheduler can still choose to place it there even if the actual utilization of the task is at max.
.sp
Setting a task\(cqs \fIuclamp_min\fP to a none zero value will effectively boost the task as when it runs it\(cqll always start from this utilization value.
.sp
By setting a task\(cqs \fIuclamp_max\fP below 1024, this will effectively cap the task as when it runs it\(cqll never be able to go above this utilization value.
.sp
The full utilization range is: [0:1024]. The special value \-1 is used to reset to system\(cqs default.
.SH "ПАРАМЕТРИ"
.sp
\fB\-m\fP
.RS 4
Встановити значення \fIutil_min\fP.
.RE
.sp
\fB\-M\fP
.RS 4
Встановити значення \fIutil_max\fP.
.RE
.sp
\fB\-a\fP, \fB\-\-all\-tasks\fP
.RS 4
Встановити або отримати атрибути обмеження використання для усіх завдань (потоків обробки) для вказаного PID.
.RE
.sp
\fB\-p\fP, \fB\-\-pid\fP
.RS 4
Працювати із наявним PID і не запускати нового завдання.
.RE
.sp
\fB\-s\fP, \fB\-\-system\fP
.RS 4
Встановити або отримати атрибути загальносистемного обмеження використання.
.RE
.sp
\fB\-R\fP, \fB\-\-reset\-on\-fork\fP
.RS 4
Встановити прапорець \fBSCHED_FLAG_RESET_ON_FORK\fP.
.RE
.sp
\fB\-v\fP, \fB\-\-verbose\fP
.RS 4
Вивести дані щодо стану.
.RE
.sp
\fB\-h\fP, \fB\-\-help\fP
.RS 4
Вивести текст довідки і завершити роботу.
.RE
.sp
\fB\-V\fP, \fB\-\-version\fP
.RS 4
Вивести дані щодо версії і завершити роботу.
.RE
.SH "КОРИСТУВАННЯ"
.sp
Типовою поведінкою є запуск нової команди:
.RS 4
\fBuclampset\fP \fI[\-m uclamp_min]\fP \fI[\-M uclamp_max]\fP \fIкоманда\fP [\fIаргументи\fP]
.RE
.sp
Ви можете отримати атрибути обмеження використання наявного завдання:
.RS 4
\fBuclampset \-p\fP \fIPID\fP
.RE
.sp
Або встановити їх:
.RS 4
\fBuclampset \-p\fP \fIPID\fP \fI[\-m uclamp_min]\fP \fI[\-M uclamp_max]\fP
.RE
.sp
Або керувати загальносистемними атрибутами:
.RS 4
\fBuclampset \-s\fP \fI[\-m uclamp_min]\fP \fI[\-M uclamp_max]\fP
.RE
.SH "ПРАВА ДОСТУПУ"
.sp
Користувач має володіти \fBCAP_SYS_NICE\fP для зміни атрибутів планування процесу. Отримати дані щодо планування може бути будь\-який користувач.
.SH "ЗАУВАЖЕННЯ"
.sp
The system wide utilization clamp attributes are there to control the \fIallowed\fP range the tasks can use. By default both \fIuclamp_min\fP and \fIuclamp_max\fP are set to 1024. This means users can set the utilization clamp values for their task across the full range [0:1024].
.sp
Приклад:
.RS 4
\fBuclampset \-s\fP \f(CR\-m 512\fP \f(CR\-M 700\fP
.RE
.sp
will prevent any task from being boosted higher than 512. And all tasks in the systems are capped to a utilization of 700. Effectively rendering the maximum performance of the system to 700.
.sp
Зверніться до документації з вашого ядра, щоб дізнатися більше про очікувану поведінку ядра.
.SH "АВТОРИ"
.sp
.MTO "qais.yousef\(atarm.com" "Qais Yousef" ""
.SH "ТАКОЖ ПЕРЕГЛЯНЬТЕ"
.sp
\fBnice\fP(1),
\fBrenice\fP(1),
\fBtaskset\fP(1),
\fBsched\fP(7)
.sp
Див. сторінку підручника щодо \fBsched_setscheduler\fP(2) та \fBsched_setattr\fP(2), щоб ознайомитися із описом схеми планування у Linux.
.SH "ЯК НАДІСЛАТИ ЗВІТ ПРО ВАДИ"
.sp
Для звітування щодо вад скористайтеся системою стеження за вадами \- \c
.URL "https://github.com/util\-linux/util\-linux/issues" "" "."
.SH "ДОСТУП ДО ПРОГРАМИ"
.sp
Програма \fBuclampset\fP є частиною пакунка util\-linux, який можна отримати з \c
.URL "https://www.kernel.org/pub/linux/utils/util\-linux/" "архіву ядра Linux" "."