This directory contains an example client/server application that uses the Proton library.
The applications implement a simple mailbox server.  Clients "post" and "fetch" messages
to named mailboxes on the server.

Files:

    server - the mailbox server.  This server listens to client requests on a well know
    address.  Clients may request to post a message to a mailbox, or fetch a message from
    a mailbox.  When a message is posted, if the mailbox does not exist it is created and
    the message is stored in it.  Should additional messages arrive for the mailbox, they
    are queued in the order of arrival.  When a mailbox is fetched, the next (oldest)
    message in the mailbox is removed from the mailbox and sent to the client.  If a
    client attempts to fetch from a non-existent mailbox, a zero-length message is
    returned.

    post - a client that sends a message to a mailbox on the server.

    fetch - a client that retrieves a message from a mailbox on the server.

To run the example:

    1) Start the server application.  You may specify the address the server should listen
    on.  The default address is 0.0.0.0:5672.  The server application should be left
    running for the following steps.

    2) Post a message to the server using the 'post' application.  For example, the
    following command would post the message "Hello World" to the mailbox "Mailbox-1" on
    server 0.0.0.0:5672 :

              post -m Mailbox-1 "Hello World"

    use the --help option for additional details.

    3) Fetch a message from the server using the 'fetch' application.  For example, the
    following command would fetch the message sent in the previous step:

              fetch Mailbox-1

    use the --help option for additional details.

    Once you are done running the example, you may stop the server application.


Optional - using SSL to encrypt the data connections between the server and the clients:

    The Proton driver library has support for SSL/TLS [1].  The mailbox example can be
    configured to use SSL to encypt the connections between the server and the post/fetch
    clients.

    Use the ssl-setup.sh script to create the trusted certificates database, and an
    identifying certificate for the server [2].

    Once ssl-setup.sh has created all the necessary certificates, you supply the server
    with these parameters:

    $ server --ssl-cert-file ./server-certificate.pem --ssl-key-file ./server-private-key.pem --require-encryption --ssl-cert-db ./trusted_db --ssl-key-pw "trustno1"

    And give the fetch/post clients the path to the database containing the trusted
    certificates:

    $ post -m myMailbox --ssl-cert-db ./trusted_db "Here is a message"
    $ fetch --ssl-cert-db ./trusted_db  myMailbox


[1] At the time of this writing SSL/TLS is implemented using OpenSSL, and is only
available on those platforms that support the OpenSSL libraries.

[2] Running ssl-setup.sh will require you have the "openssl" and "c_rehash" tools
installed and available on your $PATH.  See http://www.openssl.org.