Пример демонстрирует механизм создания аварийного дампа в решении на базе KasperskyOS.
Директория примера в SDK
Код примера и скрипты для сборки находятся по следующему пути:
/opt/KasperskyOS-Community-Edition-<platform>-<version>/examples/dump_collector
Список программ
Launcher – прикладная программа, запускающая процесс, который будет аварийно завершен.ExecMgrEntity – системная программа, управляющая жизненным циклом процессов через IPC-механизмы.DumpCollector – системная программа, формирующая дамп при аварийном завершении процесса.EntropyEntity – системная программа, реализующая генератор случайных чисел.VfsSdCardFs – системная программа, поддерживающая файловую систему SD-карт.BlobContainer – системная программа, предназначенная для загрузки бинарных данных в память и используемая программой Execution Manager для запуска процессов.DCM – системная программа, предоставляющая функциональность для динамического создания IPC-каналов.SDCard – драйвер SD-карты.При сборке примера для целевой аппаратной платформы в решение автоматически включаются платформенно-зависимые драйверы:
BSP – пакет поддержки аппаратной платформы (англ. Board Support Package). Обеспечивает кросс-платформенную настройку периферии для Radxa ROCK 3A и Raspberry Pi 4 B.Bcm2711MboxArmToVc – драйвер для работы с сопроцессором VideoCore (VC6) через технологию mailbox для Raspberry Pi 4 B.Описание инициализации
Файл описания инициализации решения init.yaml генерируется в процессе сборки решения на основе шаблона ./einit/src/init.yaml.in. Макросы вида @INIT_*@, которые содержатся в шаблоне, автоматически раскрываются в итоговом файле init.yaml. Подробнее см. "Шаблон init.yaml.in".
Описание политики безопасности
Файл security.psl содержит описание политики безопасности решения на базе KasperskyOS и находится в директории ./einit/src. Декларации в PSL-файле снабжены комментариями, которые поясняют назначение этих деклараций.
Описание политики безопасности решения в этом примере разрешает любые взаимодействия процессов между собой и ядром. Эту политику можно использовать только в качестве заглушки на ранних стадиях разработки решения, чтобы модуль безопасности не препятствовал взаимодействиям. В реальном решении на KasperskyOS применять такую политику недопустимо.
Ресурсы
Файлы ./resources/xdl/application/Application.edl и ./resources/xdl/launcher/Launcher.edl являются EDL-описаниями программ.
Сценарий работы
Программа Launcher запускает процесс с именем application.Application, используя функцию StartEntity() из интерфейса IApplicationController компонента Execution Manager. Через входной параметр info эта функция принимает параметры для запуска процесса в виде структуры StartEntityInfo. В поле mode структуры StartEntityInfo устанавливается значение Dump:
// Политика обработки аварийного завершения процесса:
// CrashMode::None – не выполнять никаких действий;
// CrashMode::Dump – создать аварийный дамп;
// CrashMode::Panic – выключить или перезагрузить аппаратную платформу.
info.mode = execution_manager::CrashMode::Dump;
Запущенный процесс выполняет действия, приводящие к его аварийному завершению. При аварийном завершении процесса автоматически формируется аварийный дамп. Этот дамп содержит диагностические данные: трассировку стека, состояние регистров процессора, информацию о потоках и карту памяти процесса. Сформированный аварийный дамп выводится в консоль с использованием компонента LogRR.
Сборка и запуск примера
Для сборки и запуска примера используется система CMake из состава KasperskyOS Community Edition.
См. "Сборка и запуск примеров".
В начало