diff options
Diffstat (limited to 'examples')
-rw-r--r-- | examples/chat/README | 42 |
1 files changed, 42 insertions, 0 deletions
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: + +<forwarder> + <in> + <bind addr = "tcp://eth0:5555"/> + </in> + <out> + <bind addr = "tcp://eth0:5556"/> + </out> +</forwarder> + +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 + |