Пример mass_storage

Пример демонстрирует использование драйвера UsbMassStorage в решениях на базе KasperskyOS для работы с внешним USB-накопителем, подключенным к USB-порту аппаратной платформы.

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

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

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

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

• Client – прикладная программа, которая обнаруживает подключение внешнего USB-накопителя, монтирует его первый раздел с файловой системой ext4 в директорию /mnt и проверяет работоспособность файловой системы путем выполнения тестовых операций (создание, запись, чтение и удаление файла).
• FileVfs – прикладная программа, реализующая серверную часть виртуальной файловой системы, предоставляя интерфейс для взаимодействия с файловыми системами и блочными устройствами.
• USB – драйвер для управления всеми типами USB-устройств.
• UsbMassStorage – драйвер для доступа к данным на внешних USB-накопителях (USB-флеш-накопители, внешние жесткие диски).
• EntropyEntity – системная программа, реализующая генератор случайных чисел.
• DCM – системная программа, позволяющая динамически создавать IPC-каналы.

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

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

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

Файлы описания политики безопасности решения на базе KasperskyOS находятся в директории ./einit/src.

Файл security.psl содержит описание политики безопасности решения. Файл dynld.psl содержит описание политики безопасности, необходимой для корректной работы динамической линковки в решении, и включен в файл верхнего уровня security.psl через декларацию use.

Ресурсы

В директории ./resources/xdl/mass_storage содержатся EDL-описания для программ Client и FileVfs.

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

Программа Client взаимодействует с программой FileVfs, которая выступает в роли VFS-сервера, через IPC-интерфейс. FileVfs монтирует файловую систему ext4 с внешнего USB-накопителя в директорию /mnt. Для проверки функциональности монтирования Client последовательно выполняет следующие операции: создает файл new_file, записывает в него строку test_message, считывает содержимое и удаляет файл. Результаты каждой операции выводятся в стандартный поток вывода.

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

Чтобы подготовить USB-накопитель для использования в этом примере, необходимо вызвать следующие команды:

# В следующих командах /dev/sde – имя блочного устройства подключенного USB-накопителя

parted /dev/sde mklabel msdos

parted /dev/sde mkpart primary ext4 0% 100%

mkfs.ext4 -L flash /dev/sde1

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