Пример iperf_separate_vfs

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

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

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

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

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

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

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

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

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

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

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

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

Файл ./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-описания.

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

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

По умолчанию, в примере используется программная эмуляция (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.

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