=================================
Build and install the application
=================================

Building socan is easy.

Get the source code
-------------------

You can either check out the source with 
`mercurial version control system <https://wiki.mercurial-scm.org/>`_
or download and unpack a tar.gz file.

Method one: Download a tar file
+++++++++++++++++++++++++++++++

Download the tar file from https://sourceforge.net/projects/socan/files/

Unpack::

  tar -xzf socan-*.tar.gz

Method two: Check out with mercurial
++++++++++++++++++++++++++++++++++++

.. note:
   You need to have the
   `mercurial version control system <https://wiki.mercurial-scm.org/>`_
   installed for this

Enter::

  hg clone http://hg.code.sf.net/p/socan/code socan

Build the application
---------------------

Regardless how you got the source code, simply enter these commands::

  cd socan
  make

The libraries are in directory "lib64", the test programs and scripts are in
directory "bin".

Install the application
-----------------------

If you want to install socan in directory "/usr/local", simply run::

  make install

If you want to define another installation directory, change variable
``PREFIX`` in file "Makefile".