TIPC demos for Linux README

Last updated: 5 Apr 2018


This directory contains a variety of demo programs for use with
TIPC, including:

1) benchmark
   Set up a configurable number of connections between a client and
   server program and measures latency and throughput. For comparison,
   even TCP ditto can be measured.

2) c_api_demo
   A client and a server program communicating via TIPC, but using a
   library layer written in C instead of working directly with socket
   primitives. This simplifies usage of TIPC.

3) connection_demo
   A client and a server program setting up a connection and sending
   a "Hello World" through i.
   The connection is set up in two ways: 
   a) Traditional TCP-style  connect() with implicit 2-way handshake.
   b) TIPC specific-style 1-way "implicit" setup.

4) golang
   A couple of examples of how to use tipc with the GO language

5) groupcast_demo
   A demo showing how unicast/anycast/multicast/broadcast can be sent
   loss free from a client to multiple servers, demonstrating the group
   communication feature's flow control and sequence guarantee.
   ../test/group_test is is a more elaborated version of this program.

6) hello_world
   A very simple connectionless demo showing how a client if necessary 
   waits for the server to come up before it sends a "Hello World" 
   message to it by using a service address.

7) inventory_sim
   A more advanced  example program illustrating how a distributed 
   application can be built using various features of TIPC.

8) iov_control
   A minimal program just showing how a server is able to receive a 
   message in recvmsg() while reading the source socket address 
   and the used destination service address.

8) multicast_demo
   A simpler multicast demo where one client sends a configurable 
   number of messages of configurable size to a server.

10)stream_demo
   Showing that a TCP style SOCK_STREAM connectiopn works when send
   and receive message buffer sizes don't match.

12)tipc-pipe
   A netcat like program on TIPC

13)topology_subscr_demo
   A demo showing how the topology service can be used to keep track
   of both logical (server program) and physical (cluster nodes)
   topology.
