`aps`

Управление адаптивными разделами планировщика

Синтаксис:

aps show [-d задержка] [-f усл_обозначение] [-l] [-v...] [имя_раздела ...] 

aps create -b бюджет [-B критический_бюджет] имя_раздела 

aps modify [-b бюджет] [-B критический_бюджет] имя_раздела 

aps modify [-y политика_банкротства ...] [-S политика_диспетчеризации...] [-s политика_безопасности ...] [-w размер_окна_мс]

Опции:

-B миллисекунды

Критический бюджет времени ЦП, в миллисекундах. Значение по умолчанию – 0.

-b бюджет

Бюджет времени ЦП, в процентах.

-d задержка

Интервал задержки (в десятых долях секунды) при использовании опции -l. Значение по умолчанию – 50.

-f усл_обозначение

В зависимости от значения усл_обозначение выводит следующую информацию:

all: все нижеперечисленное;
overall_stats: информация о последней ситуации банкротства;
scheduler: параметры планировщика потока, включая текущие настройки безопасности, политику банкротства и размер окна усреднения;
partitions: информация о разделах (в т.ч. имена, идентификаторы, родительские идентификаторы, бюджеты, критические бюджеты, а также идентификаторы процесса и последнего потока в ситуации банкротства);
usage (по умолчанию): размеры бюджета и критического бюджета, используемые в настоящий момент каждым разделом.

-l

("эль") Режим цикла. Информация выводится с периодичностью, определяемой опцией -d.

-S политика_диспетчеризации ...

Политики для планировщика адаптивного разделения. Аргумент политика_диспетчеризации может принимать одно из следующих значений:

normal (по умолчанию)
freetime_by_ratio
bmp_safety

Для получения дополнительной информации о политиках см. раздел "Политики диспетчеризации" в описании SchedCtl().

-s политика_безопасности ...

Политики безопасности, добавляемые в систему. Аргумент политика_безопасности может принимать одно из следующих значений:

root0_overall
root_makes_partitions
sys_makes_partitions
parent_modifies
nonzero_budgets
root_makes_critical
sys_makes_critical
root_joins
sys_joins
parent_joins
join_self_only
partitions_locked
recommended
flexible
basic
none (по умолчанию)

Для получения дополнительной информации о политиках см. описание SCHED_APS_ADD_SECURITY в разделе SchedCtl().

После изменения политики безопасности ее можно удалить только путем перезагрузки системы.

-v[v]...

Вывести расширенную информацию; вывести более подробную информацию по команде show:

-v – вывести информацию об использовании бюджета за период последнего окна усреднения, окна 2 (обычно это окно в 10 раз продолжительнее окна усреднения) и окна 3 (обычно это окно в 100 раз продолжительнее окна усреднения);
-vv – вывести информацию об использовании бюджета и критического бюджета за период последнего окна усреднения, окна 2 и окна 3.

-w размер_окна_мс

Размер окна усреднения для системы, в миллисекундах. Можно указать любой размер окна в диапазоне от 8 до 400 мс.

Если во время выполнения необходимо изменить величину системного такта, это изменение следует внести до определения размера окна планировщика адаптивного разделения, т.к. для внутреннего использования в системе ЗОСРВ «Нейтрино» размер окна преобразовывается из миллисекунд в такты системных часов.

Для получения дополнительной информации см. раздел "Choosing the window size" ("Выбор размера окна") в главе "System Considerations" ("Особенности системы") «Руководства системного программиста (администратора)» КПДА.10964-01, в разделе по адаптивному разделению.

-y политика_банкротства ...

Системная политика банкротства для указанных элементов. политика_банкротства может принимать одно из следующих значений:

cancel_budget: обнуляет критический бюджет проблемного раздела, что переводит диспетчеризацию раздела только на процентный способ выделения бюджета ЦП. Также исключается возникновение повторного банкротства.
log: в настоящее время не реализовано.
reboot: инициирует аварийную остановку системы с выдачей краткого сообщения, идентифицирующего проблемный раздел. Это наиболее жесткий вариант реагирования, предназначенный для использования при тестировании продукта и не допускающий игнорирование ситуаций банкротства. Применение этой опции в конечном продукте не предполагается.
basic (по умолчанию): генерирует события уведомления о банкротстве и переводит раздел в состояние "исчерпанного бюджета" на оставшийся интервал времени в окне диспетчеризации (номинально 100 мс).
recommended: соответствует комбинации cancel_budget и log.
none: отсутствие действий.

Для получения дополнительной информации о политиках см. раздел "Обработка ситуаций банкротства" в описании SchedCtl().

Платформы:

ЗОСРВ «Нейтрино»

Целевые архитектуры:

aarch64, arm, armv7, e2k, mips, ppc, x86

Описание:

Команда aps используется для создания, изменения и запрашивания адаптивных разделов из командной строки, а также для установки окна усреднения, политики безопасности и политики банкротства для всей системы.

В имени раздела не должен содержаться символ косой черты (/).

Для запуска приложения в разделе используется опция -Xaps в команде on.

Примеры:

Создание раздела с именем Drivers, бюджетом 20% и критическим бюджетом 5 миллисекунд:

aps create -b 20 -B 5 Drivers

Изменение бюджета и критического бюджета раздела Drivers – установка значений 25% и 7 миллисекунд:

aps modify -b 25 -B 7 Drivers

Определение политики банкротства recommended и политики безопасности root_makes_partitions для всей системы:

aps modify -y recommended -s root_makes_partitions

Вывод (с периодичностью 2 секунды) используемых величин бюджета и критического бюджета раздела:

aps show -l -d 20 -f usage

Поскольку usage является значением по умолчанию для опции -f, приведенная выше команда эквивалентна следующей команде:

aps show -l -d 20

Классификация:

Базовые подсистемы ЗОСРВ «Нейтрино»

Тематические ссылки:

on, pidin

SchedCtl()

Предыдущий раздел: Утилиты