Merge the following from the English version:

1.247 -> 1.249	books/handbook/ports/chapter.sgml

Submitted by:	Ryusuke Suzuki <ryusuke _at_ jp dot FreeBSD dot org>
Reviewed by:	Hiroo Ono <hiroo _at_ jp dot FreeBSD dot org>
Reference:	[doc-jp-work 1771, 1781, 1786]
This commit is contained in:
Hiroki Sato 2009-01-05 19:22:08 +00:00
parent 33400db297
commit 3b1a41e67f
Notes: svn2git 2020-12-08 03:00:23 +00:00
svn path=/head/; revision=33651

View file

@ -2,7 +2,7 @@
The FreeBSD Documentation Project
The FreeBSD Japanese Documentation Project
Original revision: 1.247
Original revision: 1.249
$FreeBSD$
-->
@ -335,7 +335,7 @@ R-deps: </screen>
この行は port がどこにあるかを示しています。
出力される他の情報は port
をインストールする際には必要となるものではありませんので、
ここでは触れないでおきます。</para>
ここでは触れないでおきます。</para>
<para>もっと詳しく検索するには、
<command>make search key=<replaceable>string</replaceable></command>
@ -603,75 +603,13 @@ docbook =
No を選んだ場合、以下の作業をおこない
Ports Collection をインストールしてください。</para>
<procedure>
<title>sysinstall を利用する方法</title>
<para>ここでは、再び <application>sysinstall</application>
を利用して Ports Collection
を手動でインストールする方法について説明します。</para>
<step>
<para><username>root</username> ユーザ権限で、以下のように
<command>sysinstall</command>
(5.2 より前の &os; では <command>/stand/sysinstall</command>)
を実行してください。</para>
<screen>&prompt.root; <userinput>sysinstall</userinput></screen>
</step>
<step>
<para>スクロールダウンして <guimenuitem>Configure</guimenuitem> を選び、
<keycap>Enter</keycap> を押してください。</para>
</step>
<step>
<para>スクロールダウンして <guimenuitem>Distributions</guimenuitem> を選び、
<keycap>Enter</keycap> を押してください。</para>
</step>
<step>
<para>スクロールダウンして <guimenuitem>ports</guimenuitem> を選び、
<keycap>Space</keycap> キーを押してください。</para>
</step>
<step>
<para><guimenuitem>Exit</guimenuitem> までスクロールアップして、
<keycap>Enter</keycap> を押してください。</para>
</step>
<step>
<para>CDROM や FTP といったインストールメディアを選択してください。</para>
</step>
<step>
<para><guimenuitem>Exit</guimenuitem> までスクロールアップして、<keycap>Enter</keycap>
を押してください。</para>
</step>
<step>
<para><keycap>X</keycap> を押して、
<application>sysinstall</application> を終了してください。</para>
</step>
</procedure>
<para>Ports Collection
をインストールしたり、最新の状態にしておくためのもう一つの方法は
<application>CVSup</application> を利用する方法です。
ports 用の <application>CVSup</application> ファイル
<filename>/usr/share/examples/cvsup/ports-supfile</filename>
をご覧ください。
<application>CVSup</application> を使うための情報や、
このファイルに関する説明は <link linkend="cvsup">CVSup を使う</link>
(<xref linkend="cvsup">) にあります。</para>
<procedure>
<title>CVSup を利用する方法</title>
<para>ここでは、<application>CVSup</application> を利用して
Ports Collection をインストールする方法について簡単に説明します。
あなたの ports ツリーを最新の状態にしておきたい、または
Ports Collection をインストールする方法や最新の状態に保つ方法を簡単に説明します。
<application>CVSup</application> についてもっと知りたいのであれば、
先ほど紹介したセクションをご覧ください。</para>
<link linkend="cvsup">CVSup を使う</link> をご覧ください。</para>
<step>
<para>まず <filename role="package">net/cvsup-without-gui</filename>
@ -740,6 +678,116 @@ docbook =
</para>
</step>
</procedure>
<procedure>
<title>Portsnap を利用する方法</title>
<para>&man.portsnap.8; は Ports Collection
を配布するための新しいシステムです。
&os;&nbsp;6.0 から追加されました。
もし、それより古いシステムをお使いでしたら、<filename
role="package">sysutils/portsnap</filename>
port をインストールしてください。</para>
<screen>&prompt.root; <userinput>pkg_add -r portsnap</userinput></screen>
<para><application>Portsnap</application> の機能についての詳細は
Portsnap を使う
<!-- ryusuke:2006/05/18
should be refer this after updating mirrors/chapter.sgml
<link linkend="portsnap">Portsnap を使う</link> -->
を参照してください。</para>
<step>
<para>もし <filename
role="directory">/usr/ports</filename> ディレクトリが存在しなければ、
以下のように空のディレクトリを作成してください。</para>
<screen>&prompt.root; <userinput>mkdir /usr/ports</userinput></screen>
</step>
<step>
<para>圧縮された Ports Collection のスナップショットを
<filename role="directory">/var/db/portsnap</filename>
にダウンロードしてください。
この作業が終われば、ネットワークへの接続を終了してもかまいません。</para>
<screen>&prompt.root; <userinput>portsnap fetch</userinput></screen>
</step>
<step>
<para>初めて <application>Portsnap</application> を使う時は、
スナップショットをまず <filename
role="directory">/usr/ports</filename> に展開してください。
</para>
<screen>&prompt.root; <userinput>portsnap extract</userinput></screen>
<para>すでに <filename
role="directory">/usr/ports</filename> が用意されていて、
アップデートだけを行ないたいのであれば、
代わりに以下のコマンドを実行してください。
</para>
<screen>&prompt.root; <userinput>portsnap update</userinput></screen>
</step>
</procedure>
<procedure>
<title>sysinstall を利用する方法</title>
<para>ここでは、<application>sysinstall</application>
を利用してインストールメディアから Ports Collection
をインストールする方法について説明します。
この方法では、リリース時の古い Ports Collection
がインストールされることに注意してください。
もし、インターネットへの接続が可能であれば、
これまでに説明した方法を使ってください。</para>
<step>
<para><username>root</username> ユーザ権限で、以下のように
<command>sysinstall</command>
(5.2 より前の &os; では <command>/stand/sysinstall</command>)
を実行してください。</para>
<screen>&prompt.root; <userinput>sysinstall</userinput></screen>
</step>
<step>
<para>スクロールダウンして <guimenuitem>Configure</guimenuitem> を選び、
<keycap>Enter</keycap> を押してください。</para>
</step>
<step>
<para>スクロールダウンして <guimenuitem>Distributions</guimenuitem> を選び、
<keycap>Enter</keycap> を押してください。</para>
</step>
<step>
<para>スクロールダウンして <guimenuitem>ports</guimenuitem> を選び、
<keycap>Space</keycap> キーを押してください。</para>
</step>
<step>
<para><guimenuitem>Exit</guimenuitem> までスクロールアップして、
<keycap>Enter</keycap> を押してください。</para>
</step>
<step>
<para>CDROM や FTP といったインストールメディアを選択してください。</para>
</step>
<step>
<para><guimenuitem>Exit</guimenuitem> までスクロールアップして、<keycap>Enter</keycap>
を押してください。</para>
</step>
<step>
<para><keycap>X</keycap> を押して、
<application>sysinstall</application> を終了してください。</para>
</step>
</procedure>
</sect2>
<sect2 id="ports-skeleton">
@ -853,27 +901,12 @@ docbook =
のマニュアルページを参照してください。</para>
</warning>
<sect3 id="ports-cd">
<title>CD-ROM からの ports のインストール</title>
<para>Ports Collection は、ネットワークに接続できることを想定しています。
もし接続できなければ、distfile のコピーを
<filename>/usr/ports/distfiles</filename>
に手動で置いてください。</para>
<indexterm>
<primary>ports</primary>
<secondary>CD-ROM からのインストール</secondary>
</indexterm>
<para>FreeBSD プロジェクトの公式 CD-ROM イメージには
もう distfiles は収録されていません。
あらかじめコンパイルされた packages が CD-ROM の大部分を占めています。
一方、FreeBSD PowerPak のような CD-ROM 製品は distfiles を収録しています。
<ulink url="http://www.freebsdmall.com/">FreeBSD Mall</ulink>
といったベンダからこれらの製品を注文できます。
このセクションではこのような FreeBSD の CD-ROM セットを持っていることを前提としています。</para>
<para>FreeBSD CD-ROM をドライブに入れ、
<filename>/cdrom</filename> にマウントしてください
(ほかのマウントポイントを使用したければ、
<makevar>CD_MOUNTPTS</makevar> 変数を設定してください)。
まず、インストールしたい port のディレクトリに移動してください。</para>
<para>まず、インストールしたい port のディレクトリに移動してください。</para>
<screen>&prompt.root; <userinput>cd /usr/ports/sysutils/lsof</userinput></screen>
@ -887,7 +920,7 @@ docbook =
<screen>&prompt.root; <userinput>make</userinput>
&gt;&gt; lsof_4.57D.freebsd.tar.gz doesn't seem to exist in /usr/ports/distfiles/.
&gt;&gt; Attempting to fetch from file:/cdrom/ports/distfiles/.
&gt;&gt; Attempting to fetch from ftp://lsof.itap.purdue.edu/pub/tools/unix/lsof/.
===&gt; Extracting for lsof-4.57
...
[extraction output snipped]
@ -931,11 +964,21 @@ docbook =
ports のコンパイルや
インストール中に表示されるこれらの警告に注意してください。</para>
<para>コンパイル時に作成される作業用ディレクトリを削除すると良いでしょう。
このディレクトリにはコンパイル時に使用されるすべての一時ファイルが含まれています。
このディレクトリを残しておくと、ディスク容量を消費するだけでなく、
port を新しいバージョンへアップデートする際に問題を引き起こす可能性があります。</para>
<screen>&prompt.root; <userinput>make clean</userinput>
===&gt; Cleaning for lsof-4.57
&prompt.root;</screen>
<note>
<para><command>make</command>、<command>make install</command>
と二つに分けられた手順の代わりに、
最初から <command>make install</command> と実行することで、
手順の二番目の操作を省くことができます。</para>
および <command>make clean</command>
と三つに分けられた手順の代わりに、
最初から <command>make install clean</command> と実行することで、
余分な操作を省くことができます。</para>
</note>
<note>
@ -947,78 +990,31 @@ docbook =
新しくインストールされたコマンドを用いる前に、
<command>rehash</command> コマンドを実行する必要があります。
このコマンドは <command>tcsh</command> などのシェルで動作します。
<command>sh</command> や
<filename role="package">shells/bash</filename>
などのシェルを使っているのであれば
<command>sh</command> のようなシェルを使っているのであれば
<command>hash -r</command> を実行してください。
詳細については、
あなたの使っているシェルのドキュメントをご覧ください。</para>
</note>
<note>
<para><ulink url="http://www.freebsdmall.com/">FreeBSD
Mall</ulink> の FreeBSD Toolkit のようなサードパーティ製の DVD-ROM
製品の中には distfiles を収録しているものがあります。
これらを Ports Collection で使うことができます。
DVD-ROM を <filename>/cdrom</filename> にマウントしてください。
ほかのマウントポイントを使用したければ、
<makevar>CD_MOUNTPTS</makevar> 変数を設定してください。
ディスク上に必要な distfiles が存在すると、
自動的に利用されます。</para>
<note>
<para>port には CD-ROM
への収録を許可しないライセンス条項を持つものがあることに
注意してください。
これにはダウンロード前に登録を必要としたり、
再配布が禁止されているなどという理由があります。
CD-ROM に含まれていない port をインストールしたい場合には、
ネットワークに接続する必要があります
(<link linkend="ports-inet">次のセクション</link>をご覧ください)。</para>
ネットワークに接続する必要があります。</para>
</note>
</sect3>
<sect3 id="ports-inet">
<title>インターネット経由での ports のインストール</title>
<para>前セクションと同じように、このセクションでは、
インターネットへの接続が可能であることを前提としています。
もしインターネット接続が不可能な場合は、
<link linkend="ports-cd">CD-ROM からのインストール</link>
や、distfile を手動で <filename>/usr/ports/distfiles</filename>
に置く作業が必要になるでしょう。</para>
<para>インターネット経由で port をインストールする方法は、
CD-ROM からインストールする場合と完全に同じです。
唯一異なる部分は distfile を CD-ROM からではなく、
インターネット経由でダウンロードするということです。</para>
<para>次のように、必要な手順は同じです。</para>
<screen>&prompt.root; <userinput>make install</userinput>
&gt;&gt; lsof_4.57D.freebsd.tar.gz doesn't seem to exist in /usr/ports/distfiles/.
&gt;&gt; Attempting to fetch from ftp://ftp.FreeBSD.org/pub/FreeBSD/ports/distfiles/.
Receiving lsof_4.57D.freebsd.tar.gz (439860 bytes): 100%
439860 bytes transferred in 18.0 seconds (23.90 kBps)
===&gt; Extracting for lsof-4.57
...
[extraction output snipped]
...
&gt;&gt; Checksum OK for lsof_4.57D.freebsd.tar.gz.
===&gt; Patching for lsof-4.57
===&gt; Applying FreeBSD patches for lsof-4.57
===&gt; Configuring for lsof-4.57
...
[configure output snipped]
...
===&gt; Building for lsof-4.57
...
[compilation output snipped]
...
===&gt; Installing for lsof-4.57
...
[installation output snipped]
...
===&gt; Generating temporary packing list
===&gt; Compressing manual pages for lsof-4.57
===&gt; Registering installation for lsof-4.57
===&gt; SECURITY NOTE:
This port has installed the following binaries which execute with
increased privileges.
&prompt.root;</screen>
<para>ご覧のとおり、
出力の違いはシステムがどこから distfile
を入手したか示す行だけです。</para>
<para>ports は、<envar>FTP_PASSIVE_MODE</envar>,
<envar>FTP_PROXY</envar>, <envar>FTP_PASSWORD</envar>
@ -1083,7 +1079,6 @@ ftp://ftp.FreeBSD.org/pub/FreeBSD/ports/distfiles/ fetch</userinput></screen>
などがあります。
利用可能なオプションがある場合にはメッセージが表示されます。</para>
</note>
</sect3>
<sect3>
<title>ports ディレクトリの変更</title>