Центр знаний
Центр знаний KasperskyOS
KasperskyOS Community Edition
Разработка под KasperskyOS
IPC и транспорт
Создание и использование собственных служб
Транспортный код на языке C++
Динамическое создание IPC-каналов при разработке...
KasperskyOS Community Edition
Онлайн-справка
FAQ Скачать Форум Запрос в поддержку

Динамическое создание IPC-каналов при разработке на языке С++ с использованием NameServer

12 января 2026

ID dynamic_IPC_kosipc

Скачать PDF

Использование системной программы NameServer является устаревшим способом динамического создания IPC-каналов. При создании нужно использовать системную программу DCM (см. "Динамическое создание IPC-каналов при разработке на языке C++ с использованием DCM").

Динамическое создание IPC-канала на стороне клиента включает следующие шаги:

  1. Подключить к клиентской программе сгенерированный заголовочный файл описания (*.edl.cpp.h).
  2. Подключить сгенерированные заголовочные файлы описаний используемых интерфейсов (*.idl.cpp.h).
  3. Подключить заголовочные файлы из состава KasperskyOS SDK:
    • /opt/KasperskyOS-Community-Edition-<platform>-<version>/sysroot-*-kos/include/kosipc/application.h
    • /opt/KasperskyOS-Community-Edition-<platform>-<version>/sysroot-*-kos/include/kosipc/make_application.h
    • /opt/KasperskyOS-Community-Edition-<platform>-<version>/sysroot-*-kos/include/kosipc/connect_dynamic_channel.h
  4. Создать объект приложения, вызвав функцию kosipc::MakeApplicationAutodetect(). (Также можно использовать функции kosipc::MakeApplication() и kosipc::MakeApplicationPureClient().)
  5. Создать и инициализировать прокси-объект для службы, реализующей требуемый интерфейс. Полный список служб с требуемым интерфейсом можно получить с помощью сервера имен (системная программа NameServer). Подробнее см. "Динамическое создание IPC-каналов (cm_api.h, ns_api.h)".
    • Создание прокси-объекта для службы, реализующей требуемый интерфейс и найденной первой среди опубликованных служб на сервере имен.
      1. Вызвать функцию MakeProxy().
      2. В качестве входного параметра функции MakeProxy() использовать вызов функции kosipc::ConnectPublishedService().
      3. Передать функции kosipc::ConnectPublishedService() указатель на имя интерфейса служб.
    • Создание прокси-объекта для любой службы из списка служб, реализующих требуемый интерфейс и опубликованных на сервере имен.
      1. Подключиться к серверу имен вызовом функции NsCreate().
      2. Получить полный список служб, реализующих требуемый интерфейс и опубликованных на сервере имен, использовав в цикле функцию NsEnumServices(). Для каждой службы из этого списка функция NsEnumServices() возвращает указатель на имя сервера (параметр server) и указатель на квалифицированное имя службы (параметр service).
      3. Из полученного на предыдущем шаге списка выбрать службу согласно реализуемой логике разрабатываемого решения.
      4. Вызвать функцию MakeProxy().
      5. В качестве входного параметра функции MakeProxy() использовать вызов функции kosipc::ConnectDynamicChannel().
      6. В функцию kosipc::ConnectDynamicChannel() передать указатели на имя сервера и квалифицированное имя службы, полученные на шаге b текущего списка.

После успешной инициализации прокси-объекта клиенту доступен вызов методов службы.

Пример

NsHandle ns;

// Подключение к серверу имен

Retcode rc = NsCreate(RTL_NULL, INFINITE_TIMEOUT, &ns);

char serverName[kl_core_Types_UCoreStringSize];

char endpointName[kl_core_Types_UCoreStringSize];

// Получение указателей на имя сервера и квалифицированное имя службы

rc = NsEnumServices(

ns, interfaceName, 0,

serverName, kl_core_Types_UCoreStringSize,

endpointName, kl_core_Types_UCoreStringSize);

// Создание и инициализация объекта приложения

kosipc::Application app = kosipc::MakeApplicationAutodetect();

// Создание и инициализация прокси-объекта

auto proxy = app.MakeProxy<Writer>(

kosipc::ConnectDynamicChannel(serverName, endpointName))

// Вызов метода требуемой службы

writer->DoSomeWork();

Динамическое создание IPC-канала на стороне сервера включает следующие шаги:

  1. Подключить к серверной программе сгенерированный заголовочный файл (*.edl.cpp.h), содержащий описание компонентной структуры сервера, включая все предоставляемые службы.
  2. Подключить заголовочные файлы из состава KasperskyOS SDK:
    • /opt/KasperskyOS-Community-Edition-<platform>-<version>/sysroot-*-kos/include/kosipc/application.h
    • /opt/KasperskyOS-Community-Edition-<platform>-<version>/sysroot-*-kos/include/kosipc/event_loop.h
    • /opt/KasperskyOS-Community-Edition-<platform>-<version>/sysroot-*-kos/include/kosipc/make_application.h
    • /opt/KasperskyOS-Community-Edition-<platform>-<version>/sysroot-*-kos/include/kosipc/root_component.h
    • /opt/KasperskyOS-Community-Edition-<platform>-<version>/sysroot-*-kos/include/kosipc/serve_connection_requests.h
    • /opt/KasperskyOS-Community-Edition-<platform>-<version>/sysroot-*-kos/include/kosipc/serve_dynamic_channel.h
    • /opt/KasperskyOS-Community-Edition-<platform>-<version>/sysroot-*-kos/include/kosipc/service_list.h
    • /opt/KasperskyOS-Community-Edition-<platform>-<version>/sysroot-*-kos/include/kosipc/simple_connection_acceptor.h
    • /opt/KasperskyOS-Community-Edition-<platform>-<version>/sysroot-*-kos/include/kosipc/ns_service_publisher.h>
  3. Создать классы, содержащие реализации интерфейсов, которые сервер предоставляет в виде служб. Создать и инициализировать объекты этих классов.
  4. Создать объект приложения, вызвав функцию kosipc::MakeApplicationAutodetect().
  5. Создать и инициализировать объект класса kosipc::components::Root, который описывает структуру компонентов и служб сервера. Эта структура генерируется из описаний в CDL- и EDL-файлах.
  6. Связать объект класса kosipc::components::Root с объектами классов, созданными на шаге 3.
  7. Создать и инициализировать объект класса kosipc::EventLoop, который реализует цикл диспетчеризации входящих IPC-сообщений, вызвав функцию MakeEventLoop(). В качестве входного параметра функции MakeEventLoop() использовать вызов функции ServeDynamicChannel(). В функцию ServeDynamicChannel() передать объект класса kosipc::components::Root, созданный на шаге 5.
  8. [Опционально] Создать и инициализировать объект класса kosipc::ServiceList, который содержит список служб для публикации на сервере. Для добавления служб в список использовать метод AddServices(). Использование объекта класса kosipc::ServiceList позволяет, например, разделять компоненты и службы сервера на группы или публиковать службы под разными именами (пример кода см. ниже).
  9. Создать и инициализировать объект класса kosipc::NsServicePublisher, который предназначен для публикации служб на сервере. В качестве входных параметров конструктору передать:
    • объект приложения из шага 4;
    • объект класса kosipc::components::Root, созданный на шаге 5, или объект класса kosipc::ServiceList, сформированный на шаге 8.

    Если публикация служб на сервере имен не требуется, создать и инициализировать объект класса kosipc::CmServicePublisher (пустой публикатор). В качестве входных параметров конструктору передать:

    • объект приложения из шага 4;
    • объект класса kosipc::components::Root, созданный на шаге 5, или объект класса kosipc::ServiceList, сформированный на шаге 8.

    Объекты, создаваемые на шагах 9-11, должны быть созданы после создания цикла диспетчеризации входящих IPC-сообщений (см. шаг 7).

    Библиотека kosipc обеспечивает гарантию: при создании объекта класса kosipc::NsServicePublisher все переданные ему службы публикуются на сервере имен, а при разрушении объекта – снимаются с публикации.

  10. Создать и инициализировать объект, который реализует обработчик приема входящих запросов на динамическое создание IPC-канала.

    При создании объекта можно использовать класс kosipc::SimpleConnectionAcceptor, который является стандартной реализацией интерфейса kosipc::IConnectionAcceptor. (Интерфейс kosipc::IConnectionAcceptor определен в файле /opt/KasperskyOS-Community-Edition-<platform>-<version>/sysroot-*-kos/include/kosipc/connection_acceptor.h.) В этом случае обработчик будет реализовать следующую логику: если запрашиваемая клиентом служба опубликована на сервере, то запрос от клиента будет принят, иначе отклонен.

    Если необходимо создать собственный обработчик, то следует реализовать свою логику обработки запросов в методе OnConnectionRequest(), унаследованном от интерфейса kosipc::IConnectionAcceptor. Этот метод будет вызываться сервером при получении от клиента запроса на динамическое создание IPC-канала.

  11. Создать объект класса kosipc::EventLoop, который реализует цикл приема входящих запросов на динамическое создание IPC-канала, вызвав функцию MakeEventLoop(). В качестве входного параметра функции MakeEventLoop() использовать вызов функции ServeConnectionRequests(). В функцию ServeConnectionRequests() передать объекты, созданные на шаге 9 и 10. Объекты можно передать с использованием умных указателей (std::shared_ptr) или обычных указателей. В первом случае библиотека kosipc берет на себя управление временем жизни объектов. Во втором случае ответственность остается за разработчиком: необходимо гарантировать, что объекты, созданные на шагах 9 и 10, не будут уничтожены до завершения работы объекта kosipc::EventLoop.

    Цикл приема входящих запросов на динамическое создание IPC-канала может быть только один. Цикл должен работать в одном потоке. После создания и запуска циклов не требуется синхронизации между потоками, в которых циклы исполняются.

  12. Запустить цикл диспетчеризации входящих IPC-сообщений в отдельном потоке, вызвав метод Run() объекта kosipc::EventLoop.
  13. Запустить в текущем потоке цикл приема входящих запросов на динамическое создание IPC-канала, вызвав метод Run() объекта kosipc::EventLoop. До запуска этого цикла клиентские процессы блокируются при создании прокси-объекта в ожидании ответа от сервера на запрос подключения.

Пример кода для объединения набора компонентов и служб сервера в список объектов типа ServiceList с помощью метода AddServices():

// Создание объекта приложения

kosipc::Application app = kosipc::MakeApplicationAutodetect();

// Создание и инициализация объекта group_1

kosipc::components::Root group_1;

group_1.component1.endpoint1 = &impl_1;

group_1.component2.endpoint2 = &impl_2;

// Создание цикла диспетчеризации входящих IPC-сообщений

kosipc::EventLoop loop1 = app.MakeEventLoop(ServeDynamicChannel(group_1));

// Создание и инициализация объекта group_2

kosipc::components::Root group_2;

group_2.component3.endpoint1 = &impl_3;

group_2.component4.endpoint2 = &impl_4;

// Создание цикла диспетчеризации входящих IPC-сообщений

kosipc::EventLoop loop2 = app.MakeEventLoop(ServeDynamicChannel(group_2));

// Создание и инициализация объекта group_3

kosipc::components::Root group_3;

group_3.component5.endpoint1 = &impl_5;

// Создание цикла диспетчеризации входящих IPC-сообщений

kosipc::EventLoop loop3 = app.MakeEventLoop(ServeDynamicChannel(group_3));

// Создание списка объектов

ServiceList endpoints;

endpoints.AddServices(group_1);

endpoints.AddServices(group_2);

endpoints.AddServices(group_3.component5.endpoint1, "SomeCustomEndpointName");

// Создание объекта, реализующего публикацию служб на сервере

kosipc::NsServicePublisher publisher(app, endpoints);

// Создание объекта, реализующего обработчик приема входящих запросов

// на динамическое создание IPC-канала

kosipc::SimpleConnectionAcceptor acceptor(app, endpoints);

// Создание объекта, реализующего цикл приема входящих запросов

// на динамическое создание IPC-канала

kosipc::EventLoop loopDynamicChannel = app.MakeEventLoop(ServeConnectionRequests(&acceptor, &publisher));

Вам помогла эта статья?
Что нам нужно улучшить?
Спасибо за ваш отзыв, вы помогаете нам становиться лучше!
Спасибо за ваш отзыв, вы помогаете нам становиться лучше!