НАЗВА

       uclampset - керування атрибутами обмеження використання системи або процесу

КОРОТКИЙ ОПИС

       uclampset [параметр] [-m uclamp_min] [-M uclamp_max] _аргумент команди

       uclampset [параметри] [-m uclamp_min] [-M uclamp_max] -p PID

ОПИС

       uclampset встановлює або отримує атрибути обмеження використання наявного PID або запускає команду із
       заданими атрибутами.

       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.

       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.

       If you’re running on asymmetric heterogeneous system like Arm’s big.LITTLE. Utilization clamping can help
       bias task placement. If the task is boosted such that util_min value is higher than the little cores'
       capacity, then the scheduler will do its best to place it on a big core.

       Similarly, if util_max 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.

       Setting a task’s uclamp_min to a none zero value will effectively boost the task as when it runs it’ll
       always start from this utilization value.

       By setting a task’s uclamp_max below 1024, this will effectively cap the task as when it runs it’ll never
       be able to go above this utilization value.

       The full utilization range is: [0:1024]. The special value -1 is used to reset to system’s default.

       Consult latest kernel documentation for more details:

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

ПАРАМЕТРИ

       -m
           Встановити значення util_min.

       -M
           Встановити значення util_max.

       -a, --all-tasks
           Встановити або отримати атрибути обмеження використання для усіх завдань (потоків обробки) для
           вказаного PID.

       -p, --pid
           Працювати із наявним PID і не запускати нового завдання.

       -s, --system
           Встановити або отримати атрибути загальносистемного обмеження використання.

       -R, --reset-on-fork
           Встановити прапорець SCHED_FLAG_RESET_ON_FORK.

       -v, --verbose
           Вивести дані щодо стану.

       -h, --help
           Вивести текст довідки і завершити роботу.

       -V, --version
           Показати дані щодо версії і завершити роботу.

КОРИСТУВАННЯ

       Типовою поведінкою є запуск нової команди:
           uclampset [-m uclamp_min] [-M uclamp_max] команда [аргументи]

       Ви можете отримати атрибути обмеження використання наявного завдання:
           uclampset -p PID

       Або встановити їх:
           uclampset -p PID [-m uclamp_min] [-M uclamp_max]

       Або керувати загальносистемними атрибутами:
           uclampset -s [-m uclamp_min] [-M uclamp_max]

ПРАВА ДОСТУПУ

       Користувач має володіти CAP_SYS_NICE для зміни атрибутів планування процесу. Отримати дані щодо
       планування може бути будь-який користувач.

ЗАУВАЖЕННЯ

       The system wide utilization clamp attributes are there to control the allowed range the tasks can use. By
       default both uclamp_min and uclamp_max are set to 1024. This means users can set the utilization clamp
       values for their task across the full range [0:1024].

       Приклад:
           uclampset -s -m 512 -M 700

       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.

       Зверніться до документації з вашого ядра, щоб дізнатися більше про очікувану поведінку ядра.

АВТОРИ

       Qais Yousef <qyousef@layalina.io>

ТАКОЖ ПЕРЕГЛЯНЬТЕ

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

       Див. сторінку підручника щодо sched_setscheduler(2) та sched_setattr(2), щоб ознайомитися із описом схеми
       планування у Linux.

ЯК НАДІСЛАТИ ЗВІТ ПРО ВАДИ

       Для звітування щодо вад скористайтеся системою стеження за вадами
       <https://github.com/util-linux/util-linux/issues>

ДОСТУП ДО ПРОГРАМИ

       Програма uclampset є частиною пакунка util-linux, який можна отримати з архіву ядра Linux
       <https://www.kernel.org/pub/linux/utils/util-linux/>.

util-linux 2.41                                    2025-07-02                                       UCLAMPSET(1)