コマンド リファレンス
JHBuild は CVS のようなツールと似たコマンド ライン構文を使用します:
jhbuild [global-options] command [command-arguments]
以下は JHBuild 全体のオプションです:
- -f, --fileconfig
-
~/.jhbuildrc のかわりに、指定された設定ファイルを使用します。
- -m, --modulesetmoduleset
-
設定ファイルに記述されたモジュール セットではなく、指定されたモジュール セットを使用します。このオプションは、モジュール セットが JHBuild のモジュール セット フォルダにある場合は相対パスで指定することができます。それ以外の場所にある場合は、絶対パスで指定します。
- --no-interact
-
ユーザに入力を求めません。このオプションは、ビルドが中断されないことが保証されるので、無人でビルドを行うような場合に便利です。
コマンドごとのオプションについては、以下で説明します。
5.1. autobuild
autobuild コマンドは、設定ファイルで指定されたモジュールを自動的にビルドして、結果を JhAutobuild にアップロードします。
jhbuild autobuild [--autogen] [--clean] [--distcheck] [--skip=module...] [--start-at=module] [--report-url=reporturl] [--verbose]
--autogen、--clean、--distcheck、--skip、および --start-at のオプションは、build コマンドに引き渡されます。
- --report-url=reporturl, -r reporturl
-
このオプションは、報告先である JhAutobuild の URL を指定します。
- --verbose, -v
-
指定された場合、JHBuild は、より詳細な出力を生成します。
5.2. bootstrap
bootstrap command コマンドは、ほとんどのモジュールのビルドに必要となる、一連のビルド ユーティリティをインストールします(例 autoconf、automake、等)。
jhbuild bootstrap
bootstrap コマンドがモジュールをビルドする方法は、build コマンドと同様ですが、bootstrap.modules モジュール セットを使用します。
利用可能なオプションについては、build コマンドを参照してください。
5.3. build
build コマンドは1つ(または複数)のパッケージを、それらの依存関係も含めてビルドします。
jhbuild build [--autogen] [--clean] [--check] [--dist] [--distcheck] [--ignore-suggests] [--no-network] [--skip=module...] [--start-at=module] [--tags=tags] [-D date] [--no-xvfb] [--try-checkout] [--no-poison] [--force] [--build-optional-modules] [--min-age=time] [module...]
コマンドラインでモジュールの名前が指定されなかった場合、設定ファイルの modules のリストが使用されます。
- -a, --autogen
-
モジュールをビルドする前に、常に autogen.sh を実行します。デフォルトでは、autogen.sh はトップ レベルの makefile が存在しない場合のみ、実行されます。それ以外の場合、JHBuild が configure をリビルド、または再実行する必要があるかの決定は、パッケージの makefile に依存します。
- -c, --clean
-
モジュールをビルドする前に、make clean を実行します。
- --check
-
モジュールをビルドした後に、make check を実行します。
- -d, --dist
-
モジュールをビルドした後に、make dist を実行します。
- --distcheck
-
モジュールをビルドした後に、make distcheck を実行します。
- --ignore-suggests
-
推奨の依存関係をビルドしません。
- -n, --no-network
-
モジュールをビルドするときに、ネットワークにアクセスしません。これによりビルドのステージで、ダウンロードと更新がスキップされます。ネットワークにアクセスしないとモジュールをビルドできない場合、モジュールのビルドは失敗します。
- -s, --skip=module,...
-
指定されたモジュールをビルドしません。依存関係のビルドをスキップするのに使用されます。
- --tags=tag,...
-
tag タグにマッチしないモジュールを無視します。tag とモジュールのモジュール セットの名前が、自動的にマッチングされます。
- -t, --start-at=module
-
リストの先頭からではなく、名前で指定されたモジュールから開始します。このオプションはビルドを中断したときなどに便利です。
- -D date
-
バージョン管理システムでサポートされていれば、ビルドの前にソース ツリーを指定された日時に更新します。ISO の日時フォーマットが要求されます。例 "2009-09-18 02:32Z"。
- -x, --no-xvfb
-
Xvfb によりシミュレートされたものではなく、実際の X サーバでグラフィカルなテストを実行します。
- -C, --try-checkout
-
もしビルドが失敗したとき、バージョン管理システムがサポートしている場合はビルドを再試行する前に、強制的にチェックアウトして autogen.sh を実行します。
- -N, --no-poison
-
1つ(または複数)のモジュールの依存関係のビルドに失敗した場合、とにかくモジュールをビルドするよう JHBuild に強制します。
- -f, --force
-
ビルドを要求しないポリシーでも、指定されたモジュールをビルドします。
- --build-optional-modules
-
モジュールをビルドするのに必須ではないモジュールは、オプショナルな依存関係としてリストされます。このオプションは JHBuild にたいして、オプショナルな依存関係のビルドを強制します。
- --min-age=time
-
指定された相対時間より最近にインストールされたモジュールをスキップします。time の文字列書式は、単位を付加した数字です。付加する単位は、次のものがサポートされています: 秒 (s)、分 (m)、時間 (h)、日 (d)。例えば、--min-age=2h は2時間前以降にビルドされたモジュールをスキップします。
5.4. buildone
buildone コマンドは、build と似ていますが、依存するモジュールをビルドしません。このコマンドは、1つ(または複数)のモジュールをリビルドするときに便利です。
jhbuild buildone [--autogen] [--clean] [--check] [--distcheck] [--no-network] [-D date] [--no-xvfb] [--force] [--min-age=time] module...
--autogen、--check、--clean、-d、--distcheck、--no-network、-D、そして -x のオプションは、build コマンドで処理されます。
コマンドラインで、少なくとも1つのモジュールを指定しなければなりません。
5.5. checkbranches
checkbranches は、バージョン管理システムでブランチが正しく定義されているか、およびブランチのモジュール セットに矛盾がないかをチェックします。
jhbuild checkbranches [--branch=branch...]
- --branch=branch, -bbranch
-
チェックするブランチを指定します。
$ jhbuild -m gnome-2.20 checkbranches libgnomecanvas is missing branch definition for gnome-2-20 $
5.6. clean
clean コマンドは1つ(または複数)のビルド ディレクトリをクリーンします。
jhbuild clean [--skip=module...] [--start-at=module]
コマンドラインでモジュールの名前が指定されなかった場合、設定ファイルの modules のリストが使用されます。
利用可能なオプションについては build コマンドのドキュメントの説明を参照してください。
5.7. dot
dot コマンドは、モジュール間の依存関係によって形成された、有向グラフが記述されたファイルを生成します。このファイルは、ダイアグラムを生成する GraphViz ソフトウェアで処理することができます。
jhbuild dot [--soft-deps] [--clusters] [module...]
コマンドラインでモジュールの名前が指定されなかった場合、設定ファイルの modules のリストが使用されます。
--soft-deps オプションはモジュールから、推奨される依存関係への点線を追加します。--clusters オプションは metamodules によりモジュールをグループ化します。
dot コマンドの出力は、dot ユーティリティにパイプすることにより、PostScript ファイルを生成することができます:
$ jhbuild dot modules | dot -Tps > dependencies.ps
PNG イメージを生成することもできます:
$ jhbuild dot modules | dot -Tpng > dependencies.png
5.8. gui
gui コマンドは、JHBuild のためにモジュールを選択したり、いくつかのビルド オプションを変更できる、グラフィカルなインタフェースを起動します。
jhbuild gui
グラフィカルなインタフェースの描画には GTK を使用しているので、追加のサポート ライブラリが必要です。
5.9. info
info コマンドは、1つ(または複数)のモジュールの情報を表示します。
jhbuild info module...
このコマンドはモジュールの名前、タイプ、依存関係、依存するパッケージ、JHBuild で最後にインストールされた日時を表示します。もし可能なら、そのモジュールの CVS リポジトリやダウンロード元の URL などの、具体的な情報も表示されます。
コマンドにモジュールが指定されなかった場合、モジュール セットで定義されたすべてのモジュールについての情報が表示されます。
5.10. list
list コマンドは、build コマンドがビルドするモジュールのリストを、展開して表示します。
jhbuild list [-a] [-r] [-s] [--start-at=module] [--tags=tags] [--ignore-suggests] [--list-optional-modules] [module...]
コマンドラインでモジュールの名前が指定されなかった場合、設定ファイルの modules のリストが使用されます。
--skip、--start-at、--tags、および --ignore-suggests のオプションは、build コマンドに引き渡されます。
- -a, --all-modules
-
ビルドの依存関係に関わらず、モジュール セットのモジュールをすべて一覧します。
- -r, --show-revision
-
モジュールがブランチとして設定されている場合、モジュール名とともにブランチ名が表示されます。
- --list-optional-modules
-
このオプションは JHBuild にたいして、オプショナルな依存関係の一覧を強制します。
5.11. rdepends
rdepends コマンドは、モジュールの依存関係を逆方向に表示します。
jhbuild rdepends [module]
- --dependencies
-
モジュールの横に、依存関係のパスを表示します。
- --direct
-
指定されたモジュールと直接の依存関係にあるモジュールに、表示を限定します。
5.12. run
run コマンドは、JHBuild がモジュールをビルドするのに使用するのと同じ環境で、指定したコマンドを実行します。
jhbuild run [--in-builddir] [--in-checkoutdir] program [argument...]
GNOME をビルドするのに JHBuild を使用する場合、このコマンドは X の起動スクリプトなどで便利です。
- --in-builddir=module
-
指定したモジュールの、ビルド ディレクトリでコマンドを実行します。
- --in-checkoutdir=module
-
指定したモジュールの、ソース ディレクトリでコマンドを実行します。
5.13. sanitycheck
sanitycheck コマンドは、ビルド環境に問題がないことを確認するために、いくつかのチェックを行います。
jhbuild sanitycheck
以下のチェックが含まれます:
-
チェックアウト先とインストール先が書き込み可能か。
-
必要なビルド ツールがインストールされているか。
-
さまざまなバージョンの automake に関連付けられている aclocal コマンドの検索パスで、よく使用されるマクロが利用可能か。
-
XML カタログに DocBook の DTD と スタイル シートが含まれているか。
5.14. shell
shell コマンドは、JHBuild がモジュールをビルドするのと同じ環境で、ユーザ シェルを起動します。
jhbuild shell
このコマンドは以下のコマンドと同じです:
$ jhbuild run $SHELL
このシェルが実行されている場合、環境変数 UNDER_JHBUILD が "true" に設定されます。これを利用すれば、JHBuild の制御下にあるシェルであることが確信できるように、あなたのシェルのプロンプトをカスタマイズできます。例えば、あなたの .bashrc に、以下のような設定をしたいと思うでしょう:
if [ -n "$UNDER_JHBUILD" ]; then PS1="[jhbuild] $PS1" fi
これにより、あなたの bash シェルは、通常のプロンプトの前に [jhbuild] を表示するようになるので、どのシェルが JHBuild の制御下にあるかを識別しやすくなります。
5.15. tinderbox
tinderbox コマンドは、build コマンドに似ていますが、すべての端末出力を、ウェブサイトで発行しやすいような HTML ファイルに出力します。このコマンドは Mozilla の Tinderbox や、Debian の Buildd と同じようにシステムをセットアップします。
jhbuild tinderbox [--autogen] [--clean] [--no-network] [--output=directory] [--skip=module...] [--start-at=module] [-D date] [-C] [-N] [-f] [module...]
--autogen、--clean、--no-network、--skip、--start-at、-D、-C、-N、そして -f のオプションは、build コマンドで処理されます。
- -o, --output=directory
-
HTML ファイルを出力するディレクトリです。
5.17. update
update コマンドは build コマンドに似ていますが、モジュールのビルドは行わずに、ダウンロードと更新のステージのみ実行します。
jhbuild update [--skip=module...] [--start-at=module] [--tags=tags] [--ignore-suggests] [-D date] [module...]
--skip、--start-at、--tags、--ignore-suggests、および -D options オプションは、 build コマンドで処理されます。
5.18. updateone
updateone コマンドは update と似ていますが、依存するモジュールをビルドしません。このコマンドは、1つ(または複数)のモジュールをビルドするときに便利です。
jhbuild updateone [-D date] module...
-D オプションは、build コマンドで処理されます。
コマンドラインで、少なくとも1つのモジュールを指定しなければなりません。