Bjamのオプション

bjam [options] [properties] [targets]

options

「-x」形式のオプションはBjamコマンドのオプションであり、「--name」形式のオプションはBBv2のオプションである。

properties

プロパティを「フィーチャー=値」の形式で設定する。toolsetやvariantのようなimplicitフィーチャーは「フィーチャー=」を省略できる。また、値を複数設定する場合は「,」で区切る。

さらに、「プロパティA/プロパティB」のようにすることで、プロパティAが使用される場合のみプロパティBを設定するよう指定できる。

プロパティ	意味
gcc debug	gccでデバッグビルドを行う。
link=static/shared	スタティックライブラリと共有ライブラリを共にビルドする。
gcc/debug/threading=multi	gccでマルチスレッド用にデバッグビルドを行う。
gcc/debug msvc/release	gccでデバッグビルドを、VisualC++でリリースビルドを行う。
gcc/toolset-gcc:flavor=mingw,cygwin	MInGWとCygwinのgccでビルドする。

targets

ビルドするターゲットをターゲットIDで指定する。既定ではexplicit指定されていない全てのターゲットをビルドする。

ターゲットcleanは--cleanオプションと同じ働きを持つ。

-a

全てのターゲットを再構築する。

-d n

デバッグメッセージの出力レベルをnに設定する。

-d +n

出力レベルnのデバッグメッセージのみ出力する。

-d 0

デバッグメッセージの出力を抑制する。

-f jambase

組み込みのビルドスクリプトを使用する代わりに、jambaseを使用する。

-j n

n個のビルドコマンドを平行して実行する。

-l n

ビルドコマンドの実行時間をn秒に制限する。

-n

実際にビルドを行う代わりにビルドコマンドを表示する。

-o file

ビルドコマンドをfileに出力する。

-q

ターゲットのビルドに失敗したら、他のターゲットのビルドを続行せずに終了する。

-s var=value

グローバル変数varの値をvalueに設定する。

-t target

targetとそれに依存するターゲットを再構築する。

-v

bjamのバージョンを出力して終了する。

--clean: ターゲットをビルドする代わりに削除する。
--clean-all: 外部プロジェクトも含め、全てのターゲットを削除する。
--version: BBv2とBjamのバージョンを表示し、終了する。
--help: ヘルプメッセージを表示し、終了する。
--help module-name: モジュールmodule-nameのヘルプコメントを表示し、終了する。
--help module-name.rule-name: ルールmodule-name.rule-nameのヘルプコメントを表示し、終了する。
--debug-configuration: モジュールの設定に関するデバッグメッセージを表示する。
--test-config=file: site-config.jamとuser-config.jamの代わりにfileを使用する。
--site-config=file: site-config.jamの代わりにfileを使用する。
--user-config=file: user-config.jamの代わりにfileを使用する。
--toolset=name: ツールセットnameを自動設定して、ビルドに使用する。
--verbose-test: unit-testモジュールを利用した単体テストで成功時にも標準出力/エラー出力の内容を表示する。