os/doc
3
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

- Merge the following from the English version:

Browse source 
r44016 -> r44420	head/ja_JP.eucJP/books/handbook/ports/chapter.xml
This commit is contained in:
Ryusuke SUZUKI 2014-12-25 11:10:23 +00:00
parent 777e0a1afe
commit 097a4f56d0
Notes: svn2git 2020-12-08 03:00:23 +00:00 
svn path=/head/; revision=46123
1 changed files with 61 additions and 51 deletions

112
ja_JP.eucJP/books/handbook/ports/chapter.xml
View file

@ -3,7 +3,7 @@
The FreeBSD Documentation Project
The FreeBSD Japanese Documentation Project
Original revision: r44016
Original revision: r44420
$FreeBSD$
-->
<chapter xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0" xml:id="ports">
@ -252,7 +252,7 @@
ports ツリーのローカルバージョンを調べることができます。
port がどのカテゴリに分類されているのかを知りたければ、
&man.whereis.1; コマンドで調べることができます。
<command>whereis ファイル</command>
<command>whereis <replaceable>ファイル</replaceable></command>
と入力してください。<replaceable>ファイル</replaceable>
の部分にはインストールを考えているプログラム名を入れます。</para>
@ -319,8 +319,10 @@ Path: /usr/ports/sysutils/lsof
Info: Lists information about open files (similar to fstat(1))</screen>
<para>もっと詳しく検索するには、
<command>make search key=string</command> または
<command>make quicksearch key=string</command>
<command>make search
key=<replaceable>string</replaceable></command> または
<command>make quicksearch
key=<replaceable>string</replaceable></command>
と入力してください。
<replaceable>string</replaceable>
の部分には検索したいテキストを入れます。
@ -567,7 +569,7 @@ docbook =
&man.pkg.version.1; を使ってインストールされている package
のバージョンを調べるか、ワイルドカードを使ってください。</para>
<screen>&prompt.root; <userinput>pkg_delete xchat\*</userinput></screen>
<screen>&prompt.root; <userinput>pkg_delete <replaceable>xchat\*</replaceable></userinput></screen>
<para>上の例では、名前が <literal>xchat</literal>
で始まるすべての packages が削除されます。</para>
@ -709,7 +711,7 @@ pkg-1.1.4_1</screen>
ここで <replaceable>packagename</replaceable> は、インストールする
package の名前です。</para>
<screen>&prompt.root; <userinput>pkg install packagename</userinput></screen>
<screen>&prompt.root; <userinput>pkg install <replaceable>packagename</replaceable></userinput></screen>
<para>このコマンドは、リポジトリデータを使用して、
インストールすべきソフトウェアのバージョン、および、
@ -827,7 +829,7 @@ Deinstalling ca_root_nss-3.15.1_1... done</screen>
<replaceable>pkgng.db</replaceable>
を適切なファイル名に置き換えてください。</para>
<screen>&prompt.root; <userinput>pkg backup -d pkgng.db</userinput></screen>
<screen>&prompt.root; <userinput>pkg backup -d <replaceable>pkgng.db</replaceable></userinput></screen>
<para>さらに、<application>pkgng</application> は
package データベースを毎日自動的にバックアップする
@ -907,8 +909,7 @@ Deinstalling ca_root_nss-3.15.1_1... done</screen>
依存 packages を再インストールするには、
以下のように実行してください。</para>
<screen>&prompt.root; <userinput>pkg install -Rf graphics/freeglut</userinput></screen>
<screen>&prompt.root; <userinput>pkg install -Rf <replaceable>graphics/freeglut</replaceable></userinput></screen>
</note>
</sect2>
</sect1>
@ -1295,7 +1296,7 @@ Deinstalling ca_root_nss-3.15.1_1... done</screen>
変更することができます。
設定する場合には、変更先を以下のようにして指定してください。</para>
<screen>&prompt.root; <userinput>cd /usr/ports/directory</userinput>
<screen>&prompt.root; <userinput>cd /usr/ports/<replaceable>directory</replaceable></userinput>
&prompt.root; <userinput>make MASTER_SITE_OVERRIDE= \
<replaceable>ftp://ftp.organization.org/pub/FreeBSD/ports/distfiles/</replaceable> fetch</userinput></screen>
@ -1644,62 +1645,64 @@ The deinstallation will free 229 kB
<title><application>Poudriere</application> を用いた
package の構築</title>
<para><application>Poudriere</application> は、&os; jails を用いて、
<para><application>poudriere</application> は、&os; package
を作成したり、試験に用いられる <acronym>BSD</acronym>
ライセンスのユーティリティです。
このユーティリティは、&os; jails を用いて、
独立したコンパイル環境を構築します。
この中で、ports は、通常の &man.make.1; ターゲットおよび &man.pkg.8;
によってコンパイルされ、package 化されます。</para>
インストールされている &os; のバージョンとは異なるバージョン用の
package を作成したり、ホストが &arch.amd64; のシステムでは、
i386 用の package を構築することもできます。
package が構築されたら、そのレイアウトは公式のミラーと同じなので、
&man.pkg.8; や他の package 管理ツールで利用できます。</para>
<sect2 xml:id="poudriere-installation-and-configuration">
<title>インストールと設定</title>
<para>Ports Collection
(<package role="port">ports-mgmt/poudriere</package>)
から <application>Poudriere</application>
をインストールしてください。</para>
<para>設定ファイルは、
<filename>/usr/local/etc/poudriere.conf</filename> と
<filename>/usr/local/etc/poudriere.d/</filename> です。
設定例は
<para><package role="port">ports-mgmt/poudriere</package> package
または port から <application>poudriere</application>
をインストールしてください。
アプリケーションをインストールすると、サンプルの設定ファイルである
<filename>/usr/local/etc/poudriere.conf.sample</filename>
に用意されています。</para>
もインストールされます。
このファイルを
<filename>/usr/local/etc/poudriere.conf</filename> にコピーして、
ローカルの環境に合わせて編集してください。</para>
<para>必ずしも <acronym>ZFS</acronym> を使う必要はありませんが、
<para><application>poudriere</application> を実行するシステムで、
必ずしも <acronym>ZFS</acronym> を使う必要はありませんが、
有用です。<acronym>ZFS</acronym> を使う際には、
<application>Poudriere</application> の <varname>ZPOOL</varname>
を指定する必要があります。
<varname>FREEBSD_HOST</varname> を最も近いミラーに設定してください。
他の値はデフォルトの値で十分です。
<filename>/usr/local/etc/poudriere.conf</filename>
の中で <varname>ZPOOL</varname> を指定する必要があります。
そして、<varname>FREEBSD_HOST</varname>
を最も近いミラーに設定してください。
<varname>CCACHE_DIR</varname> を定義することで、
<package role="port">devel/ccache</package>
を使ったコンパイルのキャッシュが可能となり、
コンパイルで頻繁に使われるコードの構築時間を短縮できます。
<application>Poudriere</application> データセットを
<application>poudriere</application> データセットを
<filename class="directory">/poudriere</filename>
にマウントされた独立したツリーに置くと良いでしょう。
これは機能的な変更ではなく、趣味の問題です。</para>
他の値はデフォルトの値で十分です。</para>
<para>同時に走らせるコンパイル数の定義には、
認識されたコアプロセッサの数が用いられます。
<acronym>RAM</acronym>
もしくはスワップ空間のどちらかの仮想メモリを十分用意してください。
もし、仮想メモリを使い切ってしまったら、jail の構築は中断し、
<!-- 壊れてしまい、-->
異常なメッセージが表示されることでしょう。</para>
</sect2>
<sect2 xml:id="poudriere-initialization">
<title>Jails および Port ツリーの初期化</title>
<para>最初は、&os; ツリーと ports ツリーをインストールすれば十分です。
<option>-j</option> および <option>-v</option>
で名前とバージョンを与えるだけで簡単にセットアップできます。
<para>設定が終わったら、<application>poudriere</application>
を初期化して、必要とする &os; ツリーおよび jail、
そして ports ツリーをインストールしてください。
jail の名前を <option>-j</option>、
&os; のバージョンを <option>-v</option> で指定してください。
&os;/&arch.amd64; システムでは、
<option>-a</option> を使ってアーキテクチャに
<literal>i386</literal> または <literal>amd64</literal>
を設定できます。
デフォルトは、
<command>uname</command> で表示されるアーキテクチャが設定されます。</para>
デフォルトでは、<command>uname</command>
で表示されるアーキテクチャを使うように設定されます。</para>
<screen>&prompt.root; <userinput>poudriere jail -c -j <replaceable>10amd64</replaceable> -v <replaceable>10.0-RELEASE</replaceable></userinput>
====&gt;&gt; Creating 10amd64 fs... done
@ -1750,7 +1753,7 @@ Building new INDEX files... done.</screen>
<para>一つのコンピュータ上で、
複数の設定、複数の jails、異なる port ツリーから
<application>Poudriere</application> は port をビルドできます。
<application>poudriere</application> は port をビルドできます。
これらのコンビネーションのカスタム設定は
<emphasis>セット</emphasis> と呼ばれます。
詳細は &man.poudriere.8; の CUSTOMIZATION の章をご覧下さい。</para>
@ -1774,18 +1777,19 @@ devel/git
ports-mgmt/pkg
...</programlisting>
<para>オプションや依存関係の ports を設定してください。</para>
<para>特定の ports に対し、
オプションや依存を設定してください。</para>
<screen>&prompt.root; <userinput>poudriere options -j <replaceable>10amd64</replaceable> -p <replaceable>local</replaceable> -z <replaceable>workstation</replaceable> -f <replaceable>workstation-pkglist</replaceable></userinput></screen>
<para>最後に packages を構築し、
&man.pkg.8; リポジトリを生成してください。</para>
package リポジトリを生成してください。</para>
<screen>&prompt.root; <userinput>poudriere bulk -j <replaceable>10amd64</replaceable> -p <replaceable>local</replaceable> -z <replaceable>workstation</replaceable> -f <replaceable>workstation-pkglist</replaceable></userinput></screen>
<para><keycombo
action="simul"><keycap>Ctrl</keycap><keycap>t</keycap></keycombo>
は現在の状況を表示します。
は現在のビルド状況を表示します。
<application>Poudriere</application> は
<filename>/poudriere/logs/bulk/<replaceable>jailname</replaceable>
</filename>
@ -1793,12 +1797,12 @@ ports-mgmt/pkg
このファイルをウェブサーバと共に使うことで、
ビルド情報を表示できます。</para>
<para><application>Poudriere</application>
リポジトリから package
をインストールに利用できるようになりました。</para>
<para>ビルドが終了したら、<application>poudriere</application>
リポジトリを package
のインストールに利用できるようになります。</para>
<para><application>Poudriere</application>
に関するより多くの情報については
<para><application>poudriere</application>
を利用する上でのより多くの情報については、
&man.poudriere.8; およびメインのウェブサイトである <link
xlink:href="https://fossil.etoilebsd.net/poudriere/doc/trunk/doc/index.wiki"></link>
を参照してください。</para>
@ -1820,8 +1824,14 @@ ports-mgmt/pkg
<para>多くのアプリケーションでは、
デフォルトの設定ファイルが、少なくとも一つは
<filename>/usr/local/etc</filename> にインストールされます。
この設定ファイルを確認し、
必要に応じてシステムの要求に合うように編集してください。</para>
数多くの設定ファイルを持つようなアプリケーションでは、
それらのファイルを格納するためにサブディレクトリを作成するものもあります。
サンプルの設定ファイルは、しばしば <filename>.sample</filename>
といった拡張子がついた名前でインストールされます。
設定ファイルを確認し、
必要に応じてシステムの要求に合うように編集してください。
最初にサンプルファイルを <filename>.sample</filename>
を外した名前のファイルにコピーしてから、編集してください。</para>
</listitem>
<listitem>