この文書ではエンドユーザが setup.rb を使って
パッケージをインストールする方法を説明します。
通常は次のように打つだけで十分です。
(UNIX 系 OS ではおそらくスーパーユーザ権限が必要です)
($ su) # ruby setup.rb
自分のホームディレクトリ以下にインストールしたいときは 次のようにしてください。
$ ruby setup.rb all --prefix=$HOME
以下、もう少し詳細に説明します。
setup.rb ではインストールのプロセスが「config」「setup」「install」
の三つの段階に分かれています。setup.rb を引数なしで実行すると
config setup install を一気に実行してしまうのですが、次のように
すると三つに分けて実行できます。
$ ruby setup.rb config $ ruby setup.rb setup # ruby setup.rb install
そして各段階にオプションを付けるとインストール先などを細かく制御
することができます。例えば config に「--bin-dir=$HOME/bin」オプ
ションを付けるとコマンドが $HOME/bin にインストールされます。
詳しくは「タスクオプション」の節を見てください。
グローバルオプションとは、タスク (config や setup) に関らず
指定できるオプションのことです。必ずタスクの前に指定してください。
q,--quietメッセージ出力を最小限にする
verbose実行中の状況を詳細に表示する (デフォルトはオン)
h,--help
setup.rb の使いかたなどを表示
v,--version
setup.rb のバージョンを表示
copyright
setup.rb の著作権を表示
タスクは以下の七つです。
all
config, setup, install を一気に行う。
タスクオプションは config と共通。
config設定をチェックしたうえで保存する
show現在の設定を表示する
setupコンパイルなど、ファイル内容の変更を行うもの
installインストールを行う。
clean
setup で作成したものを消す
distclean
setup で作成したものを消す (より強力)
prefix=PATHrbdir --sodir などの共通部分stdruby=PATH
Ruby 標準ライブラリをインストールするディレクトリ
siterubycommon=PATH
バージョンに依存しない、非標準の Ruby ライブラリを
インストールするディレクトリ (site_ruby)
siteruby=PATH
バージョンつき site_ruby へのパス
bindir=PATH実行可能ファイル(コマンド)をインストールするパス
rbdir=PATH
Ruby ライブラリをインストールするパス
sodir=PATH
Ruby の拡張モジュールをインストールするパス
datadir=PATHその他のデータファイルをインストールするパス
rubypath=PATH
#! 行 (shebang) にセットする Ruby インタプリタのパス。
(実行するときに使う ruby プログラムへのパス)
rubyprog=PATH
インストールに使う ruby プログラムへのパス
makeprog=NAME
拡張モジュールのコンパイルに使用する make プログラム
without-ext拡張モジュールのコンパイル・インストールを無条件に スキップする。ただし当然ながら、インストールされる プログラム自体が拡張モジュールなしで動くようになって いなければ意味がありません。
rbconfig=PATH
デフォルト値の設定に使う rbconfig.rb
値を取るオプションはすべて --opt=value の形で指定します。
「=」のまわりに空白を入れてはいけません。各オプションの
デフォルト値は ruby setup.rb --help で見られます。
またマルチパッケージアーカイブではこれに加えて以下のオプションも使えます。
with=NAME,NAME,NAME...インストールするパッケージ
without=NAME,NAME,NAME...インストールしないパッケージ
また「--」(マイナス二つ)に続けてオプションを指定することで
extconf.rb に引数を渡すことができます。
ruby setup.rb config -- --with-tklib=/usr/lib/libtk-ja.so.8.0
no-harm挙動を表示するだけで実行しません。
prefix=PATH
config で決定したパスの先頭にさらに PATH を付加します。
config --prefix がプログラムが実行されるときのパスであるのに
対し、install --prefix はプログラムファイルをコピーするパスを
指定します。主に RPM などのバイナリパッケージ作成用です。
デフォルトは空文字列です。