`aps`

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

Синтаксис:

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

[имя_раздела ...]

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

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

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

[-s политика_безопасности ...] [-w размер_окна_мс]

Поддерживаемые платформы:

Neutrino

Опции:

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

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

-b бюджет

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

-d задержка

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

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

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

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

Значение по умолчанию – usage.

-l

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

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

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

normal
freetime_by_ratio
bmp_safety

Значение по умолчанию – normal. Для получения дополнительной информации о политиках см. раздел "Scheduling Policies" ("Политики диспетчеризации") в описании SchedCtl() в руководстве по библиотекам Neutrino Library Reference.

-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

Значение по умолчанию – none. Для получения дополнительной информации о политиках см. описание «SCHED_APS_ADD_SECURITY» в разделе SchedCtl() в руководстве по библиотекам Neutrino Library Reference.

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

-v...

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

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

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

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

Примечание. Если во время выполнения необходимо изменить величину системного такта, это изменение следует внести до определения размера окна планировщика адаптивного разделения, т.к. для внутреннего использования в системе Neutrino размер окна преобразовывается из миллисекунд в такты системных часов.

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

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

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

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

Значение по умолчанию – basic. Для получения дополнительной информации о политиках см. раздел "Handling bankruptcy" ("Обработка ситуаций банкротства") в описании SchedCtl() в руководстве по библиотекам Neutrino Library Reference.

Описание:

Команда 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