Пример net2_with_separate_vfs

Пример демонстрирует установку соединения через TCP-сокеты между программой-клиентом, запущенной в KasperskyOS, и программой-сервером, запущенной в хостовой операционной системе.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Пример net2_with_separate_vfs является видоизмененным примером net_with_separate_vfs. В отличие от примера net_with_separate_vfs, в этом примере программа взаимодействует по сети не с другой программой, запущенной в KasperskyOS, а с внешним сервером.

Пример состоит из программы Client, запущенной в KasperskyOS, и программы Server, запущенной в хостовой операционной системе Linux. Программа Client и программа Server связаны TCP-сокетом. В коде программы Client используются стандартные функции POSIX.

Чтобы соединить программы Client и Server сокетом, программа Client должна взаимодействовать с программой VfsNet. Программа VfsNet при сборке компонуется с сетевым драйвером, который обеспечит взаимодействие с программой Server, запущенной в Linux.

IP-адрес программы Server задан в файле ./CMakeList.txt переменной SERVER_IP и имеет значение по умолчанию 10.0.2.2. Значения по умолчанию для программы Client (имя интерфейса, адрес, сетевая маска и адрес шлюза) взяты из файла /opt/KasperskyOS-Community-Edition-<platform>-<version>/sysroot-*-kos/include/kos_net.h. Вы можете изменить эти значения в соответствии с конфигурацией вашей сети в файле client/src/client.c, расположенном в директории примера.

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

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

Для корректной работы примера необходимо запустить программу Server в хостовой операционной системе Linux или на компьютере, подключенном к аппаратной платформе.

Если пример запускается в QEMU, то программа Server будет собрана и запущена в хостовой операционной системе Linux автоматически. После выполнения сборки, исполняемый файл server программы Server находится в следующей директории:

<название примера>/build/host/server/

Если пример запускается на аппаратной платформе, то необходимо собрать исполняемый файл программы Server самостоятельно, выполнив следующие команды:

$ export PATH="/opt/KasperskyOS-Community-Edition-<platform>-<version>/toolchain/bin/:$PATH"

$ cd net2_with_separate_vfs/server/

$ cmake -G "Unix Makefiles" -B ./build

$ cmake --build ./build/ --target server

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