Пример logrr

Пример демонстрирует использование компонента LogRR для журналирования работы программ в решении на базе KasperskyOS.

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

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

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

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

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

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

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

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

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

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

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

В директории ./resources/hdd/etc расположены файлы конфигурации для программ VfsNet, Dhcpcd и Ntpd: hosts, dhcpcd.conf и ntp.conf соответственно.

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

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

Файл ./logrr/CMakeLists.txt содержит инструкции для сборки и запуска подсистемы логирования. Создается два канала вывода: для сохранения полученных от сервера журналирования сообщений в файл и для их вывода в последовательный порт (UART).

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

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

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

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

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

1. Проверяет наличие сети. Если сеть не доступна, программа выводит сообщение об ошибке и продолжает работу без сети.
2. Ожидает синхронизации с NTP-серверами в течение 5 секунд.
3. Инициализирует клиентскую часть компонента LogRR.
4. Отправляет сообщения в журнал с использованием макроса LOG.

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

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

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