Пример shared_libs

Пример демонстрирует использование статических и динамических библиотек в KasperskyOS.

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

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

/opt/KasperskyOS-Community-Edition-<platform>-<version>/examples/shared_libs

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

• Client – прикладная программа, использующая статические и динамические библиотеки.
• VfsSdCardFs – системная программа, поддерживающая файловую систему SD-карт.
• DCM – системная программа, позволяющая динамически создавать IPC-каналы.
• BlobContainer – системная программа, необходимая для работы с динамическими библиотеками в разделяемой памяти.
• SDCard – драйвер SD-карты.
• EntropyEntity – системная программа, реализующая генератор случайных чисел.

При сборке примера для целевой аппаратной платформы в решение автоматически включаются платформенно-зависимые драйверы:

• BSP – пакет поддержки аппаратной платформы (англ. Board Support Package). Обеспечивает кросс-платформенную настройку периферии для Radxa ROCK 3A и Raspberry Pi 4 B.
• GPIO – драйвер поддержки GPIO для Radxa ROCK 3A.
• PinCtrl – драйвер низкоуровневой конфигурации мультиплексирования пинов (pinmux) для Radxa ROCK 3A.
• 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-файле снабжены комментариями, которые поясняют назначение этих деклараций.

Ресурсы

В директории ./resources/xdl/shared_libs расположен файл Client.edl – EDL-описание программы Client.

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

В примере программа Client выполняет следующие действия:

• вызывает функцию из статической библиотеки hello_s;
• вызывает функцию из динамической библиотеки hello_d1, скомпонованной вместе с программой и загружаемой в память при запуске процесса;
• вызывает функцию из динамической библиотеки hello_d2, загружаемой в память при вызове функции dlopen() интерфейса POSIX.

Чтобы динамические библиотеки могли быть разделяемыми между разными процессами, в пример включена системная программа BlobContainer.

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

Для сборки и запуска примера используется система CMake из состава KasperskyOS Community Edition.

Для корректной работы примера shared_libs на целевой аппаратной платформе после сборки примера и подготовки загрузочной SD-карты требуется выполнить следующие действия:

• создать директорию /lib на загрузочной SD-карте, если этой директории не существует;
• скопировать в директорию /lib на загрузочной SD-карте содержимое директории build/hdd/lib, которая генерируется во время сборки примера.

Если образ загрузочной SD-карты создается с использованием функции build_sd_image(), то никаких дополнительных действий выполнять не требуется.

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