名前
libtoolize - Makefile に libtool の機能を付加する。
書式
libtoolize [-cfn] [--automake] [--copy] [--debug] [--dry-run] [--force] [--ltdl] [--ltdl-tar]
libtoolize [--help] [--version]
説明
libtoolize は Makefile に libtool(1) の機能を 付加するための標準的な方法を提供する。
もし autoconf や automake を使っているならば、 ‘configure.in’ ファイルに AM_PROG_LIBTOOL の呼び出しを 追加すべきである。 このマクロを使うと ‘configure’ スクリプトと ltconfig を シームレスに統合できる。
aclocal プログラムは configure スクリプトに AM_PROG_LIBTOOL 機能を自動的に付加する。 あなたの libtool.m4 のコピーを acinclude.m4 に インクルードしておくことを推奨する。 なぜなら、あなたのマクロのバージョンと acinclude.m4 の バージョンが合わない場合にユーザーが aclocal.m4 や configure を リビルドすると、互換性のないマクロのために終了しないかもしれないからである。
マクロでは ‘Makefile.in’ において Makefile の変数 top_builddir を定義する必要がある。 automake はこれを自動で行うが、 autoconf ユーザーは、この変数をビルドディレクトリのトップへの相対パスで (‘../..’ といったように) 設定すべきである。
| AM_PROG_LIBTOOL | |||||
| ライブラリパッケージの名前によって、
共有/静的のどちらのライブラリをビルドするかをユーザーが指定できるように、
--enable-shared[=PACKAGE,...] をサポートする。
パッケージ名が ‘default’ の場合、環境変数 PACKAGE にその名前がない
すべてのパッケージがマッチする。
デフォルトではこのマクロは、もし可能であれば、 共有ライブラリの使用を有効にする。 さらに静的ライブラリが共有ライブラリと衝突しなければ、 静的ライブラリの使用も有効にする。 AM_DISABLE_SHARED または AM_DISABLE_STATIC マクロを 呼び出すことにより、このデフォルトを変更することができる。 # ビルドプロセスが非常に長くなるので、 # ベータテストの間は共有ライブラリを無効にする。 AC_DISABLE_SHARED AM_PROG_LIBTOOL マクロは環境変数 LIBTOOL_DEPS も設定する。 この変数は libtool スクリプトが古くなったときに 自動的に更新するために使われる。 そのためには、configure.in に以下を加え、
さらに Makefile.in または Makefile.am に以下を加えること。
| |||||
| AC_DISABLE_FAST_INSTALL | |||||
| デフォルトの動作を AM_PROG_LIBTOOL でなく すべての最適化を無効にするよう変更し、インストールを高速化する。 ユーザーは --enable-shared と同じように、 --enable-fast-install[=PACKAGE,...] を指定することで このマクロを上書きすることができる。 | |||||
| AC_DISABLE_SHARED | |||||
| AM_PROG_LIBTOOL に対するデフォルトの動作を 共有ライブラリを無効とするように変更する。 ユーザーは --enable-shared を指定することにより、 このデフォルトの動作を更に変更することができる。 | |||||
| AC_DISABLE_STATIC | |||||
| AM_PROG_LIBTOOL に対するデフォルトの動作を 静的ライブラリを無効とするように変更する。 ユーザーは --enable-static を指定することにより、 このデフォルトの動作を更に変更することができる。 | |||||
| AC_LIBTOOL_DLOPEN | |||||
| パッケージが -dlopen または -dlpreopen を 使用するためには、このマクロを使用すること。 このマクロは AMPROG_LIBTOOL より前に呼ばれなければならず、 ダイナミックロード機能のチェックを有効にする。 さもなければ、libtool はプラットホームがダイナミックロードを サポートしていないと仮定する。 | |||||
| AC_LIBTOOL_WIN32_DLL | |||||
| パッケージが win32 プラットホーム上でクリーンな dll をビルドするように
移植された場合には、このマクロを使用すること。
このマクロは AMPROG_LIBTOOL より前に呼ばれなければならず、
リンクモードで -no-undefined が libtool に渡されなければならない。
これは通常、ライブラリデータアイテムが ‘__declspec(dllexport)’ で エクスポートされ、‘__declspec(dllimport)’ インポートされることを意味している。 このマクロが使用されないと、libtool はパッケージライブラリは dll クリーンでないと仮定して、win32 ホスト上で静的ライブラリしか作らなくなる。 | |||||
オプション
| -c, --copy | シンボリックリンクを作らず、 libtool データディレクトリからファイルをコピーする。 |
| -f, --force | |
| 既存の libtool ファイルを置き換える。 デフォルトでは libtoolize は既存のファイルを上書きしない。 | |
| -n, --dry-run | |
| ファイルの作成・修正・削除をせず、libtoolize によって どのようなコマンドが実行されるかを表示する。 | |
| --automake | |
| 静かに動作させるとともに、 Automake の libtool 機能が使用されることを仮定する。 AM_PROG_LIBTOOL が ‘configure.in’ にある場合、 パッケージに libtool ファイルを追加するために Automake により ‘libtoolize --automake’ が使用される。 | |
| --debug | シェルスクリプトのトレースモードを有効にし、標準出力に書き出す。 |
| --ltdl | パッケージのサブディレクトリに libltdl をインストールする。 |
| --ltdl-tar | |
| パッケージに libtdl.tar.gz を追加する。 | |
| --help | 使用法のメッセージを標準出力に表示し、正常終了する。 |
| --version | |
| バージョン情報を標準出力に表示し、正常終了する。 | |
関連項目
libtool(1), ltconfig(1)
注意
プログラムのバグについては <bug-libtool@gnu.org> へ報告してください。 man ページは Ragnar Hojland Espinosa <ragnar@ragnar-hojland.com> が作成しました。
