KasperskyOS Community Edition 1.3

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

Чтобы реализовать клиентскую программу, вызывающую метод службы, предоставляемой серверной программой, необходимо:

1. Подключить сгенерированный заголовочный файл описания (*.edl.cpp.h) клиентской программы.
2. Подключить сгенерированные заголовочные файлы описаний используемых интерфейсов (*.idl.cpp.h).
3. Подключить заголовочные файлы из состава KasperskyOS SDK:
   • sysroot-*-kos/include/kosipc/application.h
   • sysroot-*-kos/include/kosipc/api.h
   • sysroot-*-kos/include/kosipc/connect_static_channel.h
4. Создать и инициализировать объект приложения, вызвав функцию kosipc::MakeApplicationAutodetect(). (Также можно использовать функции kosipc::MakeApplication() и kosipc::MakeApplicationPureClient().)
5. Получить клиентский IPC-дескриптор канала и идентификатор службы (riid) вызвав функцию kosipc::ConnectStaticChannel().

   Функция принимает имя IPC-канала (из файла init.yaml) и квалифицированное имя службы (из CDL- и EDL-описаний компонента решения).

6. Создать и инициализировать прокси-объект для используемой службы, вызвав функцию MakeProxy().

Чтобы реализовать серверную программу, предоставляющую службы другим программам, необходимо:

1. Подключить сгенерированный заголовочный файл *.edl.cpp.h, содержащий описание компонентной структуры программы, включая все предоставляемые службы.
2. Подключить заголовочные файлы из состава KasperskyOS SDK:
   • sysroot-*-kos/include/kosipc/event_loop.h
   • sysroot-*-kos/include/kosipc/api.h
   • sysroot-*-kos/include/kosipc/serve_static_channel.h
3. Создать классы, содержащие реализации интерфейсов, которые данная программа и её компоненты предоставляют в виде служб.
4. Инициализировать объект приложения, вызвав функцию kosipc::MakeApplicationAutodetect().
5. Создать и инициализировать структуру kosipc::components::Root, которая описывает компонентную структуру программы и описания интерфейсов всех предоставляемых программой служб.
6. Связать поля структуры kosipc::components::Root с объектами, реализующими соответствующие службы.

   Поля структуры Root повторяют иерархию компонентов и служб, заданную совокупностью CDL- и EDL-файлов.

7. Получить серверный IPC-дескриптор канала, вызвав функцию ServeStaticChannel().

   Функция принимает имя IPC-канала (из файла init.yaml) и структуру, созданную на шаге 5.

8. Создать объект kosipc::EventLoop, вызвав функцию MakeEventLoop().
9. Запустить цикл диспетчеризации входящих IPC-сообщений, вызвав метод Run() объекта kosipc::EventLoop.