Ports Collection とは、/usr/ports 以下に置かれる Makefile, 修正パッチ、 説明文などの一連のファイルのことです。このファイルのセットは、 アプリケーションをコンパイルして FreeBSD にインストールするのに用いられます。 以下では、FreeBSD のセットアップ時に Ports Collection をインストールしなかった場合に、 Ports Collection を準備する方法について示します。

Portsnap の詳細と、 Portsnap を用いた ports ツリーのアップデート方法については、 Portsnap を使う の節を読んでください。

port スケルトンは、アプリケーションを FreeBSD 上で正しくコンパイルしインストールする方法を提供するファイルのセットのことです。 それぞれの port スケルトンには、次のファイルが含まれています。

これらの他に pkg-message といったファイルを含む ports もあります。 ports システムは、 このようなファイルを用いて特殊な状況にも対応しています。 これらのファイルについての詳細および ports の一般的な説明については、port 作成者のためのハンドブック をご覧下さい。

port は実際のソースコード (「distfile」 とも呼ばれます) を含んではいません。 ソースコードはソフトウェアの作者が好む形式で配布されます。 以下では port をインストールする 2 つの方法について説明します。

Ports Collection は、ネットワークに接続できることを想定しています。 もし接続できなければ、distfile のコピーを /usr/ports/distfiles に手動で置いてください。

まず、インストールしたい port のディレクトリに移動してください。

port をコンパイルまたは 「ビルド (build)」 するには、プロンプトから make と入力してください。 そうすると、次のような出力が現われるはずです。

コンパイルが終了すると、プロンプトに戻ります。 次に make install を使って、port のインストールを行ないます。

プロンプトに戻ったら、 インストールしたプログラムは実行できるようになっています。 lsof は高い権限で動作するプログラムなので、 セキュリティに関する警告が表示されます。ports のコンパイルやインストール中に表示されるこれらの警告に注意してください。

コンパイル時に作成される作業用ディレクトリを削除すると良いでしょう。 このディレクトリにはコンパイル時に使用されるすべての一時ファイルが含まれています。 このディレクトリを削除することで、ディスク容量を節約でき、また port を新しいバージョンへアップデートする際に問題が起こる可能性を小さくします。

FreeBSD Mall の FreeBSD Toolkit のようなサードパーティ製の DVD-ROM 製品の中には distfiles を収録しているものがあります。 これらを Ports Collection で使うことができます。 DVD-ROM を /cdrom にマウントしてください。 ほかのマウントポイントを使用したければ、 CD_MOUNTPTS 変数を設定してください。 ディスク上に必要な distfiles が存在すると、 自動的に利用されます。

ports は、FTP_PASSIVE_MODE, FTP_PROXY, FTP_PASSWORD といった環境変数を参照する fetch(1) を用いてファイルをダウンロードします。 ファイアウォールの内側であったり、 FTP/HTTP プロキシを使う場合には、 これらの環境変数を設定することなります。 環境変数の一覧については fetch(3) をご覧ください。

ネットワークに常時接続できないユーザのために make fetch コマンドが用意されています。 (ネットワークに接続している時に) このコマンドを /usr/ports で実行してください。 必要なファイルがダウンロードされます。 このコマンドは /usr/ports/net といった、より下の階層のカテゴリにおいても使うことができます。 ある port がライブラリやその他の ports に依存している場合には、 別のカテゴリの ports の distfiles はダウンロードされないことに注意してください。 port が依存しているすべてをダウンロードしたければ、 make fetch-recursive を使ってください。

めったにないことかもしれませんが、 デフォルトの MASTER_SITES に書かれているサイト以外から tarball を持ってくることが必要になる場合があります。 そのような場合には以下のように MASTER_SITES を変更してください。

上の例では MASTER_SITES を ftp.FreeBSD.org/pub/FreeBSD/ports/distfiles/ に変更しています。

インストールされた ports および packages は、 pkg_delete(1) コマンドで削除できます。

まず最初に pkg_version(1) コマンドを使って、 古くなってしまった ports の中で新しいバージョンにアップデート可能なものを Ports Collection からリストアップしてください。

Ports Collection を使い続けていると、 そのうちディスクを食いつぶしてしまうでしょう。 ports をビルドしてインストールした後、 make clean は作業用の work ディレクトリを削除します。 以下のコマンドで Ports Collection を掃除することができます。

時間が経つにつれ distfiles ディレクトリには、古くなったソースファイルがたまっていきます。 次のコマンドで、どの ports からも使われていない distfiles を削除できます。

システムにインストールされている port から使われていない distfiles をすべて削除するには、以下のコマンドを使ってください。

ports-mgmt/pkg_cutleaves port は、 必要なくなった ports を削除する作業を自動化します。