bjam

The bjam command is used to execute the Boost Jam build tool. It provides a convenient way to execute bjam, as well as applying a bjam post-processor to the command output by default.

The bjam command is based on the executable command, thus all attributes and child elements valid for the executable command are also valid for the bjam command.

Finding the bjam binary

The bjam command will try the following values for the bjam binary:

if a binary is specified explictly using the exe attribute, that value will be used
if a property named "bjam.bin" exists, the value of that property will be used
otherwise, the value "bjam" will be used (and thus bjam must be found in the PATH of the pulse™ process)

Attributes

Attribute	Description	Required?	Default
jamfile	Path of the Jamfile to use, relative to the base directory for the recipe.	No	Left to bjam (e.g. `Jamfile`, `Jamroot`).
targets	A space-separated list of targets to execute.	No	Default bjam behaviour.

Child Elements

See executable.

Examples

Execute the targets "build" and "test" from a default Jamfile:

<bjam name="build and test" targets="build test"/>

Execute the target "test" from the Jamfile "MyJamfile" in the directory "src":

<bjam name="test" working-dir="src" jamfile="MyJamfile" targets="test"/>