INTRODUCTION
Overview
Download and Install
Documentation
Publications

REPOSITORY
Libraries

DEVELOPER
Dev Guide
Dashboard

PEOPLE
Contributors
Users

SourceForge.net Logo
Project
Download
Mailing lists

 

         
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.

 

Generated for GearBox by  doxygen 1.4.5