Configure, Compile and Install code

This page describes how to configure, compile and install source code.

1   Before you start ...

Change to the directory containing the source code to compile.

2   Configure

Create a build directory and change into it:

Terminal
mkdir build
cd build


Now it's time to start the CMake curses-interface:

Terminal

ccmake ../


The first time you start ccmake you won't see much. That's why you have to press the c-key (c for configuration). By pressing the t-key you can see advanced options. Adopt all options to your needs. For a detailed documentation of important compile-options please view Compile options.

If you have finished configuring the options, press the c-key and after that the g-key (this will generate the configuration).

3   Make

In order to start compiling the code, please execute the following command:

Terminal

make


Alternatively, you could use ... to speed up the compilation:

Terminal

make -j2


4   Install

The installation-path depends on the settings specified during configuration. The default installation path is /usr/local.

4.1   /usr/local

If you intend to install Fesslix to /usr/local, please execute:

Terminal (as root)

sudo make install


Make sure that the file /etc/ld.so.conf exists and contains the line /usr/local/lib. Therafter, please run:

Terminal (as root)

sudo ldconfig


4.2   local installation directory

If you intend to install Fesslix in a local directory, please execute:

Terminal

make install


If installing locally (assuming you use bash as shell and CMAKE_INSTALL_PREFIX was set to $HOME/apps/) you have to append the following text to the bash configuration file:

append to the bash configuration file
if [[ -z $LD_LIBRARY_PATH ]]; then
LD_LIBRARY_PATH=$HOME/apps/lib
else
LD_LIBRARY_PATH=$LD_LIBRARY_PATH:$HOME/apps/lib
fi
export LD_LIBRARY_PATH

5   Update

Development of Fesslix is a gradual process, and – once in a while – you might want to update your installed version to the latest version. It is actually quite straightforward to update the source code of Fesslix. First, you need to change to the directory containing the source files of Fesslix and execute the following command:

Terminal

bzr merge


Thereafter, you have to go to the build directory and execute:

Terminal

make
make install


If the changes have been more severe, you might have to reconfigure the project before you can re-compile it. Therefore, in such a case, change to the build directory and execute the following commands:

Terminal
rm -r
ccmake ../
make
make install

A description on how to perform the configuration using ccmake is given in the section Configure.

fesslix.org – Home  |  Contact  |  Impressum  |  © 2015-2017 Wolfgang Betz