Here you can find all the required information to build your own freelan binary or contribute to the project.

Development

Get the source code

Freelan is hosted on github. You may clone the project there on by using the git command line:

git clone git://github.com/freelan-developers/freelan-all.git

Then:

cd freelan-all
git submodule init
git submodule update

Code structure

Freelan is composed of several projects. Namely:

  • libcryptoplus — A C++ wrapper around the OpenSSL cryptographic library.
  • libfscp — A library implementing the Freelan Secure Channel Protocol.
  • libasiotap — A extension library for Boost/Asio that adds support for virtual TAP adapters.
  • libfreelan — The main freelan library that glue all the other libraries together.
  • freelan — The main freelan binary, implemented as a Windows Service for Windows, and as a UNIX daemon for Linux/Mac OS.
  • freelan-buildtools — The build tools, as a set of Python scripts based on SConstruct.

All these libraries were written for Freelan but may be used independently in other projects. They are all licensed under the GPLv3 licence.

Getting started

All projects provide a README file which contains detailled installation instructions.

Basically, installing the build environment requires the following steps:

  • Get the source, as described in the previous sections.
  • Install one of the supported compilers: gcc or Microsoft Visual Studio.
  • Install Python and SConstruct.
  • Install the freelan build tools so they are available from the command-line.

If you need additional information or want to talk with the developers, do not hesitate to join the developers mailing-list.