KasperskyOS Community Edition 1.1

echo example

The echo example demonstrates the use of IPC transport.

It shows how to use the main tools that let you implement interaction between programs.

The echo example describes a basic case of interaction between two programs:

1. The Client program sends a number (value) to the Server program.
2. The Server program modifies this number and sends the new number (result) to the Client program.
3. The Client program prints the result number to the screen.

   

To set up this interaction between programs:

1. Connect the Client and Server programs by using the init description.
2. On the server, implement an interface with a single Ping method that has one input argument (the original number (value)) and one output argument (the modified number (result)).

   Description of the Ping method in the IDL language:

   Ping(in UInt32 value, out UInt32 result);

   

3. Create static description files in the EDL, CDL and IDL languages. Use the NK compiler to generate files containing transport methods and types (proxy object, dispatchers, etc.).
4. In the code of the Client program, initialize all required objects (transport, proxy object, request structure, etc.) and call the interface method.
5. In the code of the Server program, prepare all the required objects (transport, component dispatcher and program dispatcher, etc.), accept the request from the client, process it and send a response.

Example files

The code of the example and build scripts are available at the following path:

The echo example consists of the following source files:

• client/src/client.c – implementation of the Client program.
• server/src/server.c – implementation of the Server program.
• resources/Server.edl, resources/Client.edl, resources/Ping.cdl, resources/Ping.idl – static descriptions.
• init.yaml – init description.

Building and running example

See Building and running examples section.

The build scheme for the echo example looks as follows: