Пример iperf_separate_vfs

Пример демонстрирует использование библиотеки iperf в KasperskyOS.

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

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

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

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

• Server – прикладная программа, выполняющая функции сетевого сервера с использованием библиотеки iperf. Программа инициализирует сетевое подключение и запускает тест производительности сети в режиме сервера.
• VfsNet – системная программа, поддерживающая сетевые протоколы.
• DCM – системная программа, позволяющая динамически создавать IPC-каналы.
• EntropyEntity – системная программа, реализующая генератор случайных чисел.
• DNetSrv – драйвер сетевой карты.

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

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

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

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

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

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

Ресурсы

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

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

Программа Server выполняет следующие действия:

• Ожидает доступности сетевого интерфейса с именем, заданным макросом DEFAULT_INTERFACE с таймаутом, заданным макросом DEFAULT_TIMEOUT.
• Настраивает сетевой интерфейс с IP-адресом, заданным макросом DEFAULT_ADDR, и маской подсети, заданной макросом DEFAULT_MASK.
• Выводит в стандартный вывод ошибок список доступных сетевых интерфейсов.
• Создает новый тест iperf с использованием функции iperf_new_test().
• Инициализирует параметры теста значениями по умолчанию с использованием функции iperf_defaults().
• Обрабатывает аргументы командной строки для дополнительной настройки параметров теста с использованием функции iperf_parse_arguments().
• Запускает выполнение теста iperf в режиме сервера с использованием функции run_test().
• Выводит в стандартный вывод ошибок сообщение о начале тестирования, а после завершения теста выводит сообщение о его окончании.
• Освобождает ресурсы теста iperf с использованием функции iperf_free_test() и завершает выполнение программы с кодом EXIT_SUCCESS при успешном завершении.

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

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

По умолчанию, в примере используется программная эмуляция (SLIRP) сети в QEMU. Если вы настроили TAP-интерфейсы для QEMU, то для корректной работы примера нужно изменить сетевые параметры запуска QEMU (переменная QEMU_FLAGS) в файле ./einit/CMakeLists.txt (подробнее см. комментарии в файле).

В примере не используется DHCP, поэтому IP-адрес сетевого интерфейса должен быть указан вручную в коде программы Server (./server/src/main.cpp). SLIRP использует значения по умолчанию.

Библиотека iperf в примере используется в режиме сервера. Чтобы подключиться к этому серверу, установите программу iperf3 на хостовой машине и запустите ее с помощью команды iperf3 -c localhost. Если вы настроили TAP-интерфейсы, укажите актуальный IP-адрес вместо localhost.

Первый запуск примера может занять продолжительное время, так как клиент iperf использует энтропию /dev/urandom для заполнения пакетов случайными данными. Чтобы избежать этого, запустите клиент iperf с параметром --repeating-payload.

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