Download and Install GearBox

Note:

Reviewed for release 0.0.1

GearBox distribution has one official dependency CMake: Cross-Platform Make.

Download instructions for GearBox

• Option 1. Download the latest distribution of GearBox

• Option 2. Checkout source from SVN
  • Anonymous checkout (your username/password will be asked on commit):

    $ svn co https://gearbox.svn.sf.net/svnroot/gearbox/gearbox/trunk gearbox
    

  • See links to get started with SVN.
  • See more detailed SourceForge SVN instructions.

Installation instructions

Detailed instructions are available for these platforms/distributions:

• Debian Linux (also tested with Ubuntu/Kubuntu)
• Gentoo Linux
• Send feedback on building under other configurations.

The instructions below are quite general, follow them if your platform/distribution combination is not described above:

1. Download and install CMake: Cross-Platform Make which is used to build the GearBox distribution.

• Minimum version required 2.4-patch 4 (latest tested: 2.6-patch 3).
  • Full instructions are available from the download page.

1. Download and install any optional dependencies you'd like. Or just skip this step and do it later.
   • You may want to take a look at our notes on Installing some of GearBox's optional dependencies.
2. Build and install GearBox distribution.
   • Download the GearBox source archive and un-tar it.
   • Configure using CMake
   • Compile and install
3. Set library paths
   • Add the Gearbox library directory (by default, /usr/local/lib/gearbox) to the file /etc/ld.so.conf and run ldconfig. This will set the library path system-wide. If you wish to only set it for your user (the better option), specify the library path when linking using the -L option. For example, -L/usr/local/lib/gearbox. Setting the library path in the LD_LIBRARY_PATH environment variable is not recommended.
4. Make sure that the libraries and executables are in the path. Finished!