Пример multi_vfs_dhcpcd

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

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

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

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

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

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

• Client – прикладная программа, использует функции библиотеки libc для получения информации о сетевых интерфейсах (ioctl), которые транслируются в обращения к VFS по IPC.
• Dhcpcd – системная программа, реализующая DHCP-клиент.
• DCM – системная программа, позволяющая динамически создавать IPC-каналы.
• VfsSdCardFs – системная программа, поддерживающая файловую систему SD-карт.
• VfsNet – системная программа, поддерживающая сетевые протоколы.
• EntropyEntity – системная программа, реализующая генератор случайных чисел.
• DNetSrv – драйвер сетевой карты.
• SDCard – драйвер SD-карты.

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

• BSP – пакет поддержки аппаратной платформы (англ. Board Support Package). Обеспечивает кросс-платформенную настройку периферии для Radxa ROCK 3A и Raspberry Pi 4 B.
• Bcm2711MboxArmToVc – драйвер для работы с сопроцессором VideoCore (VC6) через технологию mailbox для Raspberry Pi 4 B.
• GPIO – драйвер поддержки GPIO для Radxa ROCK 3A.
• PinCtrl – драйвер низкоуровневой конфигурации мультиплексирования пинов (pinmux) для Radxa ROCK 3A.

Описание инициализации

Файл описания инициализации решения init.yaml генерируется в процессе сборки решения на основе шаблона ./einit/src/init.yaml.in. Макросы вида @INIT_*@, которые содержатся в шаблоне, автоматически раскрываются в итоговом файле init.yaml. Подробнее см. "Шаблон init.yaml.in".

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

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

Ресурсы

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

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

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

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

  • DHCPCD_DYNAMIC

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

  • DHCPCD_STATIC

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

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

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

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

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

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

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