INTRODUCTION Overview Download and Install Documentation Publications REPOSITORY Libraries DEVELOPER Dev Guide Dashboard PEOPLE Contributors Users Project Download Mailing lists

Installing GearBox on Debian Linux Note: Reviewed for release 0.0.1 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.4-patch 8). # 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.

---