docs/markdown/messenger/quick-start-linux.md

Linux Proton Messenger Quick Start
==============================================


On a Linux system, these instructions take you from
zero to running your first example code.  You will 
need root privileges for one of the commands.




Prerequisite Packages
---------------------------------

For a minimum build, you will need packages installed on your
box for :

        subversion
        gcc
        cmake
        libuuid-devel



Quick Start Commands
---------------------------

    svn co http://svn.apache.org/repos/asf/qpid/proton/trunk proton
    cd ./proton
    mkdir ./build
    cd ./build
    cmake ..
    make all
    # Become root and go to your build dir.
    make install
    # Stop being root.
    # Now let's see if it works.
    cd ./proton-c/examples/messenger/c
    ./recv &
    ./send
    # You're done ! ( Kill that recv process. )
    # The output you should see:

        Address: amqp://0.0.0.0
        Subject: (no subject)
        Content: "Hello World!"





Notes
----------------------------

1. If you will be editing and checking in code from this tree,
   replace the "svn co" line with this:

        svn co https://svn.apache.org/repos/asf/qpid/proton/trunk

   You must check out through https, or you will not be able to
   check in code changes from your tree.


2. The recv application in the example defaults to the same port
   as the qpid demon.  If you happen to have that demon running,
   and using the default port, the recv app above will fail.


3. If you don't have root privileges, you can still do the 
   "make install" step by setting a non-standard prefix, thus:
        cmake -DCMAKE_INSTALL_PREFIX=/my/path ..