![interreality.org [VOS]](/wwwvos/banner5.jpg)
| Creating Interreality: The Virtual Object System: Version 0.23.0 | ||
|---|---|---|
| Prev | Appendix A. Building VOS from Source | Next |
A.4. Configuring
To configure the build system for your platform run the configure script:
$ ./configureThere are a number of options that you may use with configure. Some common options are described below; for a definitive list, run ./configure --help.
- --config-cache
Cache configure results — this can reduce configure time. The cache file is called "config.cache", and can be removed to clear the cache and re-start clean. If you have problems with subdirectories (e.g. libASE), simply delete "config.cache" and omit this flag.
- --disable-optimize
Don't compile with optimizations (optimization is on by default). If you want to change the optimization level, use --enable-optimize=LEVEL, e.g. --enable-optimize=3 for level 3 (-O3). The default is level 2 (-O2).
- --disable-debug
Don't compile with debugging symbols (debugging is on by default)
- --prefix=PREFIX
Install files in PREFIX (default is /usr/local)
- --disable-readline
Don't include Readline support in mesh
- --enable-tests
Build test programs
- --enable-docs
Enable building documentation (requires DocBook toolchain)
- --disable-tutorials
Disable building tutorial programs
- --with-pkgconfig-dir=PATH
Specify an alternate installation location for the libvos pkgconfig spec file. The default is PREFIX/lib/pkgconfig. pkgconfig is a tool that automatically provides build configure scripts (e.g. 'libvos-config'). See http://www.freedesktop.org/software/pkgconfig/. This option is useful if you are installing VOS in a non-system location (e.g. /opt or /usr/local) but want to put the pkgconfig spec files in the default system-installed pkgconfig directory. (Alternatively, you can add non-system directories to an environment variable called PKG_CONFIG_PATH to let pkgconfig find them.)
- --enable-profile
Compile with profiling information
- --enable-coverage
Compile with code coverage information
- --with-boost=PATH
Look for Boost libraries installed in PATH/lib and headers in PATH/include/boost rather than default include and library paths.
- --with-howl=PATH
Look for the Howl Rendezvous/Zeroconf library installed in PATH. Default is to detect with pkg-config.
- --with-wxwidgets=PATH
If PATH is given then configure will look in this directory for the wx-config script to determine presence of wxWidgets and paths.