From c98e29fb6e017a667452cd0a50536da691600353 Mon Sep 17 00:00:00 2001 From: Martin Sustrik Date: Tue, 8 Dec 2009 21:48:39 +0100 Subject: README added to chat example --- examples/chat/README | 42 ++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 42 insertions(+) create mode 100644 examples/chat/README (limited to 'examples') diff --git a/examples/chat/README b/examples/chat/README new file mode 100644 index 0000000..bb64d60 --- /dev/null +++ b/examples/chat/README @@ -0,0 +1,42 @@ + +This example is a simple instant messaging implementation. There are multiple +partipants in the chat, both sending and reading messages. The sending +application 'prompt' is separated from the application displayinf the chat +'display' so that there's no need for sophisticated GUI. + +To run the example you'll need both applications plus the 'forwarder' device +that will play role of messaging server (chatroom). Build it this way: + +$ ./autogen.sh +$ ./configure --with-chat --with-forwarder +$ make +$ sudo make install + +Once it is build create the configuration file (say config.xml) for the +forwarder describing which network endpoints are to be used for incoming and +outgoing messages: + + + + + + + + + + +You are of course free to define mutliple endpoints for either incoming or +outgoing messages. + +Now start the forwarder: + +$ zmq_forwarder ./config.xml + +At this point the messaging server is ready to accept connections from +messaging clients. When starting the sending application, specify your name +so that messages can be attributed to you: + +$ ./prompt tcp://myserver:5555 "John Doe" + +$ ./display tcp://myserver:5556 + -- cgit v1.2.3