Пример mass_storage

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

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

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

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

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

• В пример входят системные программы, поставляемые в загрузочном образе KasperskyOS, а также дополнительные системные программы и драйверы, необходимые для работы с эмулятором или конкретной аппаратной платформе, где будет запускаться решение. Подробнее см. "Архитектура и запуск решения на базе KasperskyOS".

  Системные программы добавляются в образ решения автоматически при сборке.

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

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

Файл security.psl содержит описание политики безопасности решения на базе KasperskyOS и находится в директории ./einit/src. Декларации в PSL-файле снабжены комментариями, которые поясняют назначение этих деклараций.

Дополнительные файлы

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

Файл ./einit/CMakeLists.txt содержит инструкции для сборки загрузочного образа KasperskyOS.

В директории ./einit/src/ расположены файлы настроек системной программы ServiceManager, которая отвечает за установку и запуск KPA-пакетов:

• Файл initial_install.json содержит список KPA-пакетов, которые должны быть установлены при первом запуске KasperskyOS.
• Файл system_services.json содержит список установленных программ, которые должны запускаться каждый раз при запуске KasperskyOS.

Файлы ./einit/src/product_init_rpi4.yaml и ./einit/src/product_init_opirv2.yaml содержат параметры запуска программы FileVfs в формате Init-описания.

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

Программа 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

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