НАЗВА

       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.

ПАРАМЕТРИ

       -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 <qais.yousef@arm.com>

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

       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/>.