[ << ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
configure
スクリプトの実行 以下は,configure
スクリプトを使用したパッケージのコンフィグレー
ション方法の説明書で,パッケージの`INSTALL'ファイルに含めるのに適切
なものです.使用可能なプレーンテキストバージョンの`INSTALL' は,
Autoconfに付属しています.
13.1 基本的なインストール | Instructions for typical cases | |
13.2 コンパイラとオプション | Selecting compilers and optimization | |
13.3 複数のアーキテクチャに対するコンパイル | Compiling for multiple architectures at once | |
13.4 インストール名 | Installing in different directories | |
13.5 オプションの機能 | Selecting optional features | |
13.6 システムタイプの指定 | Specifying the system type | |
13.7 デフォルトの共有 | Setting site-wide defaults for configure
| |
13.8 変数の定義 | Specifying the compiler etc. | |
13.9 configure の呼び出し | Changing how configure runs
|
以下は一般的なインストールの説明書です.
configure
シェルスクリプトは,コンパイル時に使用する様々なシ
ステム依存の変数の正しい値を推測します.パッケージのそれぞれのディレク
トリの`Makefile'を作成するために,これらの値が使用されます.シス
テム依存の定義を含んでいる,一つ以上の`.h'ファイルも作成します.
終りに,現在のコンフィグレーションを将来再生成するために実行可能なシェ
ルスクリプト`config.status'と,コンパイラの出力を含んでいるファイ
ル`config.log' (主にconfigure
のデバッグで役立ちます)を
作成します.
再コンフィグレーションのスピードをあげるため,テストの結果を保存する追 加ファイルも使用することが可能です(通常,`config.cache'と呼ばれ, `--cache-file=config.cache'や短い`-C'で利用可能になりま す).(古いキャッシュファイルを偶然使用することによる問題を避けるため, キャッシュはデフォルトで利用不可能になっています.)
パッケージをコンパイルするため,通常行なうこと以外のことをする必要があ
る場合,configure
がどのように調査したのかを理解し,次のリリー
スに反映できるように,`README'にあるアドレスに差分や説明をメール
してください.キャッシュを使用していて,`config.cache'が含む結果
に保持したくないものがある場合,削除しても編集してもかまいません.
ファイル`configure.ac' (または`configure.in')は,
autoconf
と呼ばれるプログラムで,`configure'を作成するため
に使用されます.それを変更したり,新しいバージョンのautoconf
で
`configure'を再生成したい場合だけ,`configure.ac'が必要です.
このパッケージをコンパイルする最も単純な方法は,以下の通りです.
パッケージのソースコード含んでいるディレクトリにcd
して,システ
ムに対するパッケージのコンフィグレーションを行なうために
`./configure'と入力してください.System Vの古いバージョンの
csh
を使用している場合,csh
自身からconfigure
を
実行しないようにするため,`sh ./configure'と入力する必要があるか
もしれません.
configure
の実行にはしばらくかかります.実行中,調査している
特徴を伝えるメッセージを出力します.
パッケージをコンパイルするために`make'と入力してください.
オプションとして,パッケージ付属の自己テストを実行するため,`make check'と入力してください.
プログラムと,全てのデータファイルと,ドキュメントをインストールするた め,`make install'と入力してください.
`make clean'と入力することで,ソースコードディレクトリからプログ
ラムのバイナリやオブジェクトファイルを削除することが可能です.(異なる
種類のコンピュータに対するパッケージをコンパイルすることが可能になるよ
うに)configure
が作成したファイルも削除するためには,
`make distclean'と入力してください.`make maintainer-clean'
ターゲットもありますが,主にパッケージ開発者用です.それを使用する場合,
配布物の付属ファイルを再生成するため,いろいろな種類の他のプログラムを
入手する必要があるかもしれません.
configure
スクリプトが知らない,通常は使用しないコンパイルや
リンクのオプションが必要なシステムもあります.妥当な環境変数の詳細を得
るために,`./configure --help'を実行してください.
コマンドラインや環境変数で変数を設定することで,コンフィグレーションパ
ラメータの初期値をconfigure
に与えることが可能です.例えば以
下のようにします.
./configure CC=c89 CFLAGS=-O2 LIBS=-lposix |
詳細は,See section 変数の定義.
それぞれのアーキテクチャに対するオブジェクトファイルをそれ自身のディレ
クトリに置くことで,同時に一種類以上のコンピュータに対するパッケージを
コンパイルすることが可能です.こうするために,GNU make
の様に,
VPATH
変数をサポートするmake
のバージョンを使用する必要
があります.オブジェクトファイルと実行可能なファイルを配置したいディレ
クトリに cd
して,configure
スクリプトを実行してくだ
さい.configure
は,configure
があるディレクトリと
`..'でソースコードを自動的に調査します.
VPATH
をサポートしないmake
を使用する必要がある場合,ソー
スコードディレクトリで,一度に一つのアーキテクチャに対してパッケージを
コンパイルする必要があります.一つのアーキテクチャのパッケージをインス
トールした後,他のアーキテクチャに対して再コンフィグレーションするため,
`make distclean'を使用してください.
デフォルトで,`make install'はパッケージファイルを,
`/usr/local/bin'や`/usr/local/man'等にインストールします.イ
ンストール先の接頭辞は,`--prefix=path'オプションを
configure
に与えることで指定することが可能です.
アーキテクチャ特有のファイルと,アーキテクチャ非依存のファイルを,別々
のインストール先の接頭辞に分けて指定することが可能です.
configure
に`--exec-prefix=path'オプションを与え
た場合,パッケージはプログラムとライブラリをインストールする接頭辞とし
て,pathを使用します.ドキュメントと他のデータファイルは通常の接
頭辞を使用します.
さらに,一般的でないディレクトリへの配置を使用する場合,特定の種類のファ イルに対し異なる値で指定するように,`--bindir=path'のよう なオプションを与えることが可能です.設定可能なディレクトリリストと,そ こに置きたいファイルの種類のリストを見るために,`configure --help'を実行してください.
パッケージでサポートされている場合,configure
にオプションの
`--program-prefix=PREFIX'や
`--program-suffix=SUFFIX'を与えることで,プログラムの名前
に余分な接頭辞や接尾子を付けてインストールすることが可能です.
configure
への`--enable-feature'オプションに注意
を払うパッケージもあり,そこでのfeatureはパッケージのオプション
の部分を示しています.`--with-package'オプションに注意を
払うパッケージもあり,そこでのpackageは`gnu-as'や`x'(X
Window System用)のようなものになります.`README'でパッケージが理
解する`--enable-'と`--with-'オプションについて述べている
でしょう.
X Window Systemを使用しているパッケージに対して,configure
は
通常,Xのインクルードファイルやリンクファイルを自動的に見つけますが,
そうでない場合は,configure
オプションの
`--x-includes=dir'と`--x-libraries=dir'を,
その場所を指定するために使用することが可能です.
configure
が自動的に判定できない特徴もあるかもしれませんが,
パッケージを実行するマシンのタイプで定義する必要があるものもあります.
通常,パッケージは実行されるものと同じアーキテクチャでビルドさ
れていると仮定され,configure
はそれを判定することが可能です
が,マシンのタイプが分からない旨のメッセージを出力した場合,
`--build=type'オプションで与えてください.typeは,
`sun4'の様なシステムタイプの短い名前や,以下のような様式の標準的
な名前にすることが可能です.
cpu-company-system |
systemは,以下の形式の一つが可能です.
os kernel-os |
それぞれのフィールドでの可能な値は,ファイル`config.sub'を参照し てください.`config.sub'がパッケージに含まれていない場合,パッケー ジはマシンのタイプを知る必要がありません.
クロスコンパイルに対するコンパイラツールをビルドしている場合, コードを生成しているシステムのタイプを選択するために, `--target=type'オプションを使用すべきです.
プラットフォームに対して生成しているコードが,ビルドしているプラット フォームと異なるクロスコンパイラを使用したい場合,hostプ ラットフォーム(すなわち,生成されるプログラムが実行されるプラットフォー ム)を`--host=type'で指定すべきです.
configure
スクリプトを共有するため,デフォルト値を設定したい
場合,CC
,cache_file
,そしてprefix
の様な変数のデ
フォルト値を与える,`config.site'と呼ばれるサイトシェルスクリプト
を作成することが可能です.configure
は,存在する場合は
`prefix/share/config.site'を探し,その後で,存在する場合は
`prefix/etc/config.site'を探します.また,
CONFIG_SITE
環境変数をサイトスクリプトのある場所に設定することも
可能です.警告:全てのconfigure
スクリプトがサイトスクリプト
を探すわけではありません.
サイトのシェルスクリプトで定義されていない変数は,configure
に渡す環境変数で設定することが可能です.しかし,パッケージによってはビ
ルドしているときに再びconfigure
を実行し,カスタマイズされて
いるこれらの変数の値が消えてしまう可能性があります.この問題を避けるた
め,`VAR=value'を使用して,それらをconfigure
コマンドラ
インで設定すべきです.例えば,以下のようにします.
./configure CC=/usr/local2/bin/gcc |
これで,(サイトシェルスクリプトで優先されない限り)Cコンパイラとして
gcc
を指定します.
configure
の呼び出し configure
は,処理方法を制御する以下のオプションを理解します.
configure
オプションの概要を出力して終了します.
configure
スクリプトの生成に使用したAutoconfのバージョンを出
力して終了します.
キャッシュを可能にします.調査の結果を,通常は`config.cache'とい うfileに保存し,使用します.キャッシュを利用不可能にするため, fileはデフォルトで`/dev/null'です.
`--cache-file=config.cache'の別名です.
調査したり作成したりしているメッセージを出力しません.通常の出力も全て 省略するためには,(エラーメッセージは表示されますが)`/dev/null'に ファイルをリダイレクトしてください.
ディレクトリdirでパッケージのソースコードを探します.通常,
configure
はディレクトリを自動的に決定することが可能です.
configure
は,広範囲では役に立たないかもしれませんが,その他
のオプションも受け入れます.詳細を知るために`configure --help'を
実行してください.
[ << ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
This document was generated by Akihiro Sagawa on June, 15 2005 using texi2html 1.70.