Skip to content

hotkit/fost-base

Repository files navigation

Fost -- Core libraries

Build instructions for Windows and Linux

We have tried to make the build process as simple as possible, but due to the size and nature of the dependencies the first build is likely to take quite some time.

Step 1: if you have Boost already

If you already have Boost 1.59 (or later) available on your system you should make it available at the level above this file with the installed headers and libraries in ../Boost/install. I.e. your directory structure should look like this:

parent
|-Boost
|  |-boost (installed Boost files)
|  |  |- include
|  |  |- lib
|-fost-base
    |-README.md (location of this file)

If you do not have Boost then running build will fetch and compile a suitable version for you.

Step 2: Other pre-requisites

If you're on Windows then all of the pre-requisites will be fetched by the build script. For Linux there are a number of packages that you should have avaiable.

  • libssl-dev (cryptographic functions)
  • uuid-dev (GUID generation)
  • valgrind (testing)

On Debian based systems the following command should make sure that you have everything that you need:

apt-get install g++ libbz2-dev libssl-dev python-dev uuid-dev valgrind

Step 3: Building Fost

Within this directory you will find a build script ("build" for Linux, "build.cmd" for Windows). From a command prompt in this directory execute the script. On Linux use:

./build

And on Windows use:

build

Once completed you will find in the directory above this a folder structure in "dist" which will contain the build library files. The layout below dist depends on the platform you're building on.

Using the libraries

It is recommended that you use Bjam with Boost.Build to build projects that make use of Fost, but it is not a requirement.

In the Examples directory are various example programs that make use of different facilities within the libraries.

Bugs, issues and help

Just use any of the GitHub issue trackers.