Scroll to navigation

UCLAMPSET(1) Команди користувача UCLAMPSET(1)

НАЗВА

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

2023-07-24 util-linux 2.39.1