manページ  — PKG_ADD

package ファイルを提供する人物の能力と身元を確認するとよいでしょう。 より進んだ安全のためには、package を展開するのに -M フラグを用い、その内容と、スクリプトがシステムに害をおよぼさないかを 確認します。 +INSTALL, +POST-INSTALL, +DEINSTALL, +REQUIRE, +POST-INSTALL, +REQUIRE, +MTREE_DIRS の各ファイルには 特に注意を払い、+CONTENTS ファイルの @cwd, @mode (setuid をチェック), @dirrm, @exec, @unexec ディレクティブを調べてください。 package ファイルを調べるのには pkg_info(1) コマンドも使えます。

一つ以上の pkg-name 引数を指定することが可能で、それらは package を含むファイル名 (通常 拡張子 ".tbz" で終わります) か、ftp サイトにあるファイルを 示す URL のどちらかになります。 したがって、anonymous ftp から直接ファイルを展開することが 可能です (例えば pkg_add ftp://ftp.FreeBSD.org/pub/FreeBSD/ports/packages/shells/bash-1.14.7.tbz) 。 注意: もし上記のような転送で用いる ftp で passive mode を利用したいなら、環境変数 FTP_PASSIVE_MODE に何らかの値を設定する必要があります。 そうでなければ、より一般的な ACTIVE モードが利用されます。 もしうまく動作していることがわかっているサイトから package を 得ようとして pkg_add が常に失敗する場合、あなたが passive mode の ftp を使う必要のあるファイアウォールの中にいるのが原因である場合が あります。

1. package がすでにインストールされている、と記録されているかどうかを チェックします。 もしそうならインストールを中断します。
2. package が、既にインストール済の package と衝突するかどうかをチェックします ( @conflicts ディレクティブを読みます。 pkg_create(1) を参照)。 もしそうならインストールを中断します。
3. packing list に書かれている、package の全依存関係をスキャンします ( @pkgdep ディレクティブを読みます。 pkg_create(1) を参照)。 もし必須の package が現在インストールされていなければ、 それを見つけてインストールしようとします。 ない package がみつからなかったりインストールできなかったりすると、 インストールを中断します。
4. package がどのようにシステムに追加されるかを制御する @option ディレクティブを検索します。 このマニュアルページを書いている時点では、実装されているオプションは @option extract-in-place のみであり、これは /tmp 内の作業領域を経由しないで、 package を最終的なディレクトリに直接展開するようにします。
5. @option extract-in-place が指定されていれば、package は最終的な場所に直接展開され、 そうでなければ作業領域内に展開されます。
6. package が require ファイル ( pkg_create(1) を参照) を含んでいる場合、そのファイルを以下の引数を付けて実行します: pkg-name INSTALL ここで pkg-name は問題としている package の名前であり、 INSTALL キーワードはインストールの requirements チェックであることを 示しています (これは複数の機能を提供するひとつのスクリプトを 用いようとする場合に有用です)。
7. package に pre-install スクリプトが存在する場合、以下の引数を付けて実行されます: script pkg-name PRE-INSTALL

   ここで pkg-name は対象の package 名であり、 PRE-INSTALL はこれがインストール前のフェーズであることを示すキーワードです。

   注: ( -i および -I のフラグを pkg_create(1) に使用することにより) package 作成時に pre-install と post-install のスクリプトが別々に与えられる場合には、 PRE-INSTALL キーワードは登場しません。

8. @option extract-in-place が指定されていない場合、packing list ( +CONTENTS ファイル) が作業領域から最終的な場所に ファイルを移動 (必要ならコピー) するために参照されます。
9. package が mtreefile ファイル ( pkg_create(1) を参照) を含む場合、mtree が以下の引数を付けて実行されます: mtree -u -f mtreefile -d -e -p prefix ここで prefix は -p フラグが指定されていればその prefix、 -p フラグが指定されていない場合にはこの package の最初の @cwd ディレクティブのディレクトリ名が prefix になります。
10. package に post-install スクリプトが含まれる場合、 script pkg-name POST-INSTALL として実行されます。 ここで pkg-name は対象の package 名であり、 POST-INSTALL はこれがインストール後のフェーズであることを示すキーワードです。

    注: ( -i および -I のフラグを pkg_create(1) に使用することにより) package 作成時に pre-install と post-install のスクリプトが別々に与えられる場合には、 POST-INSTALL キーワードは登場しません。

    POST-INSTALL および PRE-INSTALL のキーワードを渡す背景には、 "インストールの前とインストール後の両方" の手続きをこなす一つの install スクリプトを用いることを可能にすることがあります。 しかしながら、メンテナンスの観点からは、機能を分離する方が有利かつ容易です。

11. インストールが終了すると、後で pkg_delete(1) で使うために packing list、 deinstall スクリプト、 description、 display の各ファイルが /var/db/pkg/<pkg-name> にコピーされます。 package の依存関係は、他の package の /var/db/pkg/<other-pkg>/+REQUIRED_BY ファイル (PKG_DBDIR 環境変数が設定してある場合、上記の /var/db/pkg/ が置き換えられます) に記録されます。
12. 最後に、作業領域が削除されプログラムは終了します。

すべてのスクリプトは環境変数 PKG_PREFIX にインストール時の prefix ( 前述の -p オプションを参照) が設定された状態で実行されます。 このことにより、package の作者は pkg_add の -p フラグにより package がインストールされるディレクトリが 変更されても、きちんとふるまうスクリプトを書くことが可能になります。

環境変数 PACKAGEROOT は、 pkg_add が取得を行う代替位置を指定します。 取得に使用する URL は、本環境変数と、 -r オプション使用時に pkg_add が自動的にディレクトリを決定する論理とで、構築されます。 設定例は "ftp://ftp3.FreeBSD.org" です。

環境変数 PACKAGESITE は、 pkg_add が取得を行う代替位置を指定します。 この変数を使用すると、 -r オプション使用時に pkg_add が自動的にディレクトリを決定する論理が破壊されます。 よって、これはリモートパッケージファイルへの完全な URL であることが必要です。