Пример multi_vfs_dhcpcd

Пример демонстрирует поддержку сетевого протокола DHCP (Dynamic Host Configuration Protocol) в KasperskyOS. Программа Dhcpcd поставляется в составе KasperskyOS Community Edition SDK и представляет собой реализацию DHCP-клиента, который выполняет настройку сетевых интерфейсов.

Дополнительно пример демонстрирует интеграцию нескольких виртуальных файловых систем (далее VFS) в одном решении. Подробнее про использование нескольких программ VFS см. в разделе "Файловые системы и сеть".

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

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

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

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

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

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

• Client – прикладная программа, использует функции библиотеки libc для получения информации о сетевых интерфейсах (ioctl), которые транслируются в обращения к VFS по IPC. В скрипте сборки программы (файл ./client/CMakeLists.txt) содержатся инструкции для упаковки прикладной программы в KPA-пакет.
• Launcher – прикладная программа, которая ожидает инициализации сетевых интерфейсов, а затем запускает программу Client. В скрипте сборки программы (файл ./launcher/CMakeLists.txt) содержатся инструкции для упаковки прикладной программы в KPA-пакет.

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

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

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

В директории ./resources/xdl/multi_vfs_dhcpcd расположен файл 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-описания.

В директории ./resources/hdd/etc расположены:

• hosts – файл конфигурации для программы VfsNet.
• dhcpcd.conf, dhcpcd_static.conf и dhcpcd_dynamic.conf – файлы конфигурации для программы Dhcpcd. В корневом файле CMakeLists.txt задается значение переменной DHCPCD_CONFIG, которое определяет выбор файла конфигурации:
  • FALLBACK

    Динамическое получение параметров сетевых интерфейсов от внешнего DHCP-сервера с переходом на статическое задание параметров в случае недоступности DHCP-сервера. Значение используется по умолчанию.

  • DYNAMIC

    Динамическое получение параметров сетевых интерфейсов от внешнего DHCP-сервера.

  • STATIC

    Статическое задание параметров сетевых интерфейсов.

  Изменить значение по умолчанию переменной DHCPCD_CONFIG можно:

  • в файле CMakeLists.txt. Например, на значение DYNAMIC:

    set (DHCPCD_CONFIG "DYNAMIC" CACHE STRING "dhcpcd config type")

  • в терминале при сборке с помощью опций Cmake:

    cmake -B build -DDHCPCD_CONFIG=DYNAMIC -D CMAKE_TOOLCHAIN_FILE="$KOSCEDIR/toolchain/share/toolchain-*-kos.cmake" && cmake --build build --target sim

Директория ./resources/hdd/var/db/dhcpcd используется программой Dhcpcd для хранения данных о подключении к сети.

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

Программа Dhcpcd поставляется в составе KasperskyOS Community Edition SDK и представляет собой реализацию DHCP-клиента, который выполняет настройку сетевых интерфейсов. Программа Client получает сведения о настроенных сетевых интерфейсах и выводит их в стандартный вывод ошибок.

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

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

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