= Building the HAMcast prototype =

== Overview ==

We developed and tested the HAMcast prototype under Ubuntu Linux (> 10.10) and MacOS X. However, it should compile and run under any other Linux distribution as well - let us know if you encounter any problems. HAMcast and most of its components are mainly written in C/C++ and use parts of the boost libraries. Some technology modules and tools need additional libraries. As HAMcast is released as open source, all external tools and libraries are also freely available and no fees have to be paid. Most, if not all of them, are available in package repositories of any common Linux distribution.
 
----

== Requirements ==

To build and run HAMcast certain tools and libraries must be available. 

 * General dependencies:
    * C/C++ Compiler (gcc, g++)
    * C/C++ standard Libraries
    * cmake tool chain (v2.6 or higher)
    * make
    * Boost Libraries (v1.42 or higher)
    * Ubuntu shortcut: 
{{{
sudo apt-get install build-essential libboost-all-dev cmake
}}}

 * IP module dependencies:
    * PCAP Library (optional, for service discovery)
    * Ubuntu shortcut: 
{{{
sudo apt-get install libpcap-dev
}}}

 * Scribe module dependencies:
    * OpenSSL Library
    * Ubuntu shortcut: 
{{{
sudo apt-get install libssl-dev
}}}

 * Monitoring Framework dependencies:
    * QT Tools and Libraries (optional, for viewer only)
    * iGraph Library (optional, for viewer only
    * Ubuntu shortcut: 
{{{
sudo apt-get install libqt4-dev  libigraph0-dev
}}}

----

== Build instructions ==

=== libhamcast ===

=== middleware ===

=== modules ===

=== programs ===

----

== Run HAMcast ==

----

== Notes ==