KasperskyOS Community Edition 1.3

Пример hello_corrosion

Пример демонстрирует, как включить в решение простую программу, разработанную на языке Rust, с использованием Corrosion – набора библиотек для интеграции Rust в CMake-проекты.

Директория примера в SDK

Код примера и скрипты для сборки находятся по следующему пути:

/opt/KasperskyOS-Community-Edition-<version>/examples/hello_corrosion

Список программ

В состав решения входит прикладная программа Hello, которая выводит сообщение в стандартный вывод ошибок. Эта программа разработана на языке Rust.

Описание инициализации

Файл описания инициализации решения init.yaml генерируется в процессе сборки решения на основе шаблона:

./einit/src/init.yaml.in

Макрос @INIT_hello_ENTITY_CONNECTIONS@ при сборке примера заменяется в файле init.yaml на список IPC-каналов со всеми системными программами, с которыми скомпонована программа Hello.

Макрос @INIT_EXTERNAL_ENTITIES@ в шаблоне init.yaml.in при сборке заменяется в файле init.yaml на список системных программ, с которыми скомпонованы прикладные программы. Этот список содержит IPC-каналы системных программ, параметры запуска функции main() и значения переменных окружения.

Подробнее см. "Шаблон init.yaml.in".

Описание политики безопасности

Файл security.psl содержит описание политики безопасности решения и генерируется в процессе сборки решения на основе шаблона:

./einit/src/security.psl.in

Макрос @INIT_EXTERNAL_ENTITIES@ в шаблоне security.psl.in при сборке решения заменяется на список системных программ, поставляемых в составе KasperskyOS SDK. Подробнее см. "Шаблон security.psl.in".

Политика безопасности решения в этом примере разрешает любые взаимодействия процессов между собой и ядром. Такая политика безопасности решения используется чтобы упростить пример. В реальном решении применять такую политику недопустимо.

Ресурсы

В директории ./resources содержится EDL-описание программы Hello.

Сценарий работы

Программа Hello выводит в стандартный вывод ошибок сообщение Hello, world!.

Сборка и запуск примера

При сборке решения используется система сборки CMake из состава KasperskyOS SDK.

Чтобы синхронизировать целевую платформу для сборки исходного-кода, разработанного на Rust, с целевой платформой C-компилятора, нужно в файле ./CMakeList.txt добавить команду:

set (Rust_CARGO_TARGET ${CMAKE_C_COMPILER_TARGET})

Чтобы использовать в решении Corrosion нужно в этом же файле добавить команду:

find_package (Corrosion REQUIRED)

Чтобы интегрировать в решение исходный код, разработанный на Rust, в файле ./hello/CMakeList.txt нужно вызвать функцию:

corrosion_import_crate (MANIFEST_PATH ${CMAKE_SOURCE_DIR}/hello/Cargo.toml)

При выполнении этой функции скомпилируется исполняемый файл hello, который будет включен в решение.

См. "Сборка и запуск примеров".