Installing GearBox on Debian Linux

Note:: Reviewed for release 9.02

These are detailed instructions for installing GearBox on Debian Linux. They are known to work for a system using Debian Testing distribution. These instructions should also be applicable to Ubuntu/Kubuntu 6.10 (Edgy). See Download and Install GearBox for general guidelines.

CMake

Minimum version required 2.4-patch 4 (latest tested: 2.6-patch 3).

# apt-get install cmake

GearBox

Basic

Build and install GearBox distribution.

Download GearBox source archive and un-tar it.

$ tar -xzf gearbox-x.x.x.tar.gz
$ cd gearbox

Configure (note the dot after cmake). The default installation directory is /usr/local. (See below on how to customize this).
```
$ cmake .
```
Compile, and install.
```
$ make
# make install
# ldconfig
```

The resultant installation tree is as follows:

[INSTALL-DIR]
    include
        gearbox
            mylib
                mylib.h
            yourlib
                yourlib.h
    lib
        gearbox
            libmylib.so
            libyourlib.so

Installation Directory

The default installation directory is /usr/local. There are two options for specifying a custom install directory:

Option 1. With cmake. This variable is stored in CMake cache so you don't have to set this variable every time: only the first time you run cmake and when you want to change it. For example:
```
$ cmake -DGEARBOX_INSTALL=$HOME/gearbox .
```
or
```
$ cmake -DGEARBOX_INSTALL=/opt/gearbox-[VERSION] .
```
Option 2. If you've changed your mind about the installation directory, you can change it at any time using ccmake tool.
```
$ ccmake .
```
Scroll down to GEARBOX_INSTALL variable, hit ENTER to edit and type in the new installation directory. When finished, hit ENTER again, then type "c" for [c]onfigure and "g" for [g]enerate. From now on, the new installation dir will be used.

That's it! We are done.