KasperskyOS Community Edition 1.3

Statically creating IPC channels for C++ development

To implement a client program that calls a method of an endpoint provided by a server program:

1. Include the generated header file (*.edl.cpp.h) of the client program description.
2. Include the generated header files of the descriptions of the utilized interfaces (*.idl.cpp.h).
3. Include the header files from the KasperskyOS SDK:
   • sysroot-*-kos/include/kosipc/application.h
   • sysroot-*-kos/include/kosipc/api.h
   • sysroot-*-kos/include/kosipc/connect_static_channel.h
4. Create and initialize the application object by calling the kosipc::MakeApplicationAutodetect() function. (You can also use the kosipc::MakeApplication() and kosipc::MakeApplicationPureClient() functions.)
5. Get the client IPC handle of the channel and the Runtime Implementation Identifier (RIID) by calling the kosipc::ConnectStaticChannel() function.

   This function gets the name of the IPC channel (from the init.yaml file) and the qualified name of the endpoint (from the CDL and EDL descriptions of the solution component).

6. Create and initialize the proxy object for the utilized endpoint by calling the MakeProxy() function.

To implement a server program that provides endpoints to other programs:

1. Include the generated header file *.edl.cpp.h containing a description of the component structure of the program, including all provided endpoints.
2. Include the header files from the KasperskyOS SDK:
   • sysroot-*-kos/include/kosipc/event_loop.h
   • sysroot-*-kos/include/kosipc/api.h
   • sysroot-*-kos/include/kosipc/serve_static_channel.h
3. Create classes containing the implementations of interfaces that this program and its components provide as endpoints.
4. Initialize the application object by calling the kosipc::MakeApplicationAutodetect() function.
5. Create and initialize the kosipc::components::Root structure, which describes the component structure of the program and describes the interfaces of all endpoints provided by the program.
6. Bind fields of the kosipc::components::Root structure to the objects that implement the corresponding endpoints.

   Fields of the Root structure replicate the hierarchy of components and endpoints that are collectively defined by the CDL and EDL files.

7. Get the server IPC handle of the channel by calling the ServeStaticChannel() function.

   This function gets the name of the IPC channel (from the init.yaml file) and the structure created at step 5.

8. Create the kosipc::EventLoop object by calling the MakeEventLoop() function.
9. Start the loop for dispatching incoming IPC messages by calling the Run() method of the kosipc::EventLoop object.