Introduction
Preliminaries
Building Boost Libraries
Configuring the tools
Supported Toolsets
Boost.Jam executable
These instructions explain how to accomplish common tasks using Boost.Build, the Boost Build System. The build system uses Boost.Jam, an extension of the Perforce Jam portable make replacement.
For tasks not covered here, see the full build system documentation.
Note that many Boost libraries are implemented entirely within their headers, and so can be used without building object libraries. Libraries that do require building object libraries first include the Python, Regex, and Threads libraries.
Using your operating system's command line interpreter, execute the following steps. The sample commands given will work for both UNIX and Windows.
chdir boost_1_28_0
(or whatever release you downloaded)
bjam "-sTOOLS=gcc metrowerks"
The build system's toolsets are designed to work in either of two ways:
bjam
command-line. These variables are used by the
build system to locate the tools and invoke the necessary
setup.
TOOLS Name | Description |
borland |
Borland C++ |
como |
Comeau C++ compiler front-end for Windows, using Microsoft Visual C++as a back-end. |
gcc |
GNU GCC on Unix and Cygwin. |
gcc-stlport |
GNU GCC on Unix and Cygwin, using the STLport standard library implementation |
gcc-nocygwin |
GNU GCC Cygwin command line compiler tools running in "no-cygwin" mode, using the STLport standard library implementation (produces commercially redistributable objects) |
intel-win32 |
Intel C++ for Windows using the Dinkumware standard library in the Intel-required Microsoft Visual C++ 6 or 7 installation |
intel-linux |
Intel C++ for Linux |
kcc |
KAI C++ |
metrowerks |
Metrowerks CodeWarrior command-line tools |
mingw |
GNU GCC and associated tools in MinGW configuration (produces commercially redistributable objects) |
mipspro |
SGI MIPSpro C and C++ |
mipspro |
SGI MIPSpro C and C++ |
msvc |
Microsoft Visual C++ command-line tools. |
msvc-stlport |
Microsoft Visual C++ command-line tools, using the STLport standard library implementation |
tru64cxx |
Compaq C++ for Tru64 UNIX (versions prior to 6.5) |
tru64cxx65 |
Compaq C++ Version 6.5 for Tru64 UNIX |
vacpp |
IBM Visual Age C++ command-line tools |
vc7 |
Microsoft Visual
C++ command-line tools, in case you are using the msvc toolset for a Visual
C++ 6.x. |
Unless otherwise specified, the library is assumed to be the one shipped with the compiler.
Additional tools can be supplied by adding an appropriate xxxx-tools.jam file to the tools/build subdirectory, where xxxx is the name of the tool being added. If you write an additional toolset file, please submit it to Boost so others may benefit from your work.
Pre-built Boost.Jam executables are available for the following platforms:
RedHat Linux RPM packages are available:
The Boost.Jam source files are included in the Boost distribution, so you can build the Boost.Jam executable yourself:
Revised 15 May, 2002
© Copyright 2001 Beman Dawes