Merge the following from the English version:

1.102 -> 1.113	books/handbook/kernelconfig/chapter.sgml

References:	[doc-jp-work 2182, 2183]
This commit is contained in:
Ryusuke SUZUKI 2011-05-14 13:54:58 +00:00
parent 38f222ba8f
commit 1ae6361f5e
Notes: svn2git 2020-12-08 03:00:23 +00:00
svn path=/head/; revision=37246

View file

@ -2,7 +2,7 @@
The FreeBSD Documentation Project
The FreeBSD Japanese Documentation Project
Original revision: 1.102
Original revision: 1.113
$FreeBSD$
-->
@ -218,7 +218,11 @@
<filename>/usr/src</filename> を消してやり直したいと思うかもし
れません。その後で、あなたがカスタマイズしたカーネルコンフィグ
レーションファイルを消してしまったことに気づくのに時間はかから
ないでしょう。</para>
ないでしょう。
また、<filename>GENERIC</filename> ファイルを直接編集しないでください。
なぜなら、編集後に
<link linkend="cutting-edge">ソースツリーをアップデート</link>
すると、ファイルが上書きされ、変更点が失われてしまいます。</para>
<para>カーネルコンフィグレーションファイルは他の場所において、
<filename>i386</filename> ディレクトリにシンボリックリンクを張
@ -471,24 +475,6 @@
<filename>/usr/src/sys/conf/NOTES</filename> に記載されています。
このファイルにも目を通すことをお奨めします。</para></note>
<important>
<title>数字と二重引用符</title>
<para>
&os; 3.x と、それまでの全てのバージョンの &os; における
&man.config.8; は、コンフィグレーションファイル中の
テキストとして使われる数字を含む文字列が
全て二重引用符で括られていなければならないという制限があります。
</para>
<para>この制限は (このハンドブックが対象としている)
4.X ブランチでは取り除かれました。
4.X 以前のシステムを使っている場合には、
サンプルとしてシステム上の
<filename>/usr/src/sys/i386/conf/LINT</filename> と
<filename>/usr/src/sys/i386/conf/GENERIC</filename>
を参照してください。</para>
</important>
<indexterm>
<primary>カーネル</primary>
<secondary>コンフィグレーションファイル例</secondary>
@ -513,14 +499,14 @@
#
# doc ディストリビューションをインストールした場合、ハンドブックは
# ローカルマシンの /usr/share/doc/handbook でも見ることができます。
# 最新版は &os; の WWW サーバ (http://www.&os;.ORG/) を参照して
# 最新版は &os; の WWW サーバ (http://www.FreeBSD.org/) を参照して
# 下さい。
#
# ./LINT コンフィギュレーションファイルには、デバイス行に関する大量の
# ../../conf/NOTES および NOTES ファイルには、デバイス行に関する大量の
# オプションと詳細な説明があります。もしある行の目的又は必要性について
# 疑問がある場合はまず LINT をチェックして下さい。
# 疑問がある場合はまず NOTES をチェックして下さい。
#
# &dollar;&os;: src/sys/i386/conf/GENERIC,v 1.246 2000/03/09 16:32:55 jlemon Exp &dollar;</programlisting>
# &dollar;FreeBSD: src/sys/i386/conf/GENERIC,v 1.380 2003/03/29 13:36:41 mdodd Exp $</programlisting>
<para>以下は <emphasis>すべての</emphasis> カーネルの構築に
必須のキーワードです:</para>
@ -532,15 +518,16 @@
<programlisting>machine i386</programlisting>
<para>マシンのアーキテクチャです。
これは <literal>i386</literal>, <literal>alpha</literal>,
<literal>pc98</literal> のいずれかでなければなりません。</para>
これは <literal>i386</literal>, <literal>pc98</literal>,
<literal>sparc64</literal>, <literal>alpha</literal>,
<literal>ia64</literal>, <literal>amd64</literal> または
<literal>powerpc</literal> のいずれかでなければなりません。</para>
<indexterm>
<primary>カーネル オプション</primary>
<secondary>cpu</secondary>
</indexterm>
<programlisting>cpu I386_CPU
cpu I486_CPU
<programlisting>cpu I486_CPU
cpu I586_CPU
cpu I686_CPU</programlisting>
@ -554,14 +541,37 @@ cpu I686_CPU</programlisting>
<filename>/var/run/dmesg.boot</filename>
ファイルを確認して起動メッセージを調べるとよいでしょう。</para>
<note><para>&os; 5.0 では、<literal>I386_CPU</literal>
へのサポートがデフォルトで無効になっています。</para></note>
<indexterm>
<primary>カーネル オプション</primary>
<secondary>cpu type</secondary>
</indexterm>
<para>&os; のソースはまだ <literal>I386_CPU</literal> に対応していますが、
-STABLE および -CURRENT では、デフォルトで無効になっています。
386 クラスの CPU に &os; をインストールするには、
以下のような方法があります。</para>
<itemizedlist>
<listitem>
<para>古い &os; リリースをインストールし、<xref linkend="kernelconfig-building">
で説明されている方法でソースコードから再構築する。</para>
</listitem>
<listitem>
<para>新しいコンピュータでユーザランドとカーネルを構築し、
このコンパイルした <filename>/usr/obj</filename> ファイルを使って
386 のコンピュータにインストールする。</para>
</listitem>
<listitem>
<para><literal>I386_CPU</literal> に対応しているカーネルを含む、自分用の
FreeBSD インストール CD-ROM を作成する。</para>
</listitem>
</itemizedlist>
<para>この 3 つの方法の中で最も簡単なのは、おそらく一番目の方法ですが、
386 クラスのコンピュータにとって用意することが難しいぐらい多くのディスク容量を必要とします。</para>
<indexterm>
<primary>カーネル オプション</primary>
<secondary>ident</secondary>
@ -594,7 +604,10 @@ cpu I686_CPU</programlisting>
<para>自動調整アルゴリズムは、<literal>maxuser</literal>
を、最小値が 32、最大値が 384
の間で、システムのメモリ合計と等しく設定します。</para>
</footnote>。それより前のバージョンの &os;
</footnote>。
&os;-5.x では <literal>maxusers</literal> が指定されないと、
デフォルトで <literal>0</literal> に設定されます。
4.5 より前のバージョンの &os;
を使っているか、自分で管理したい場合、特に
X ウインドウシステムを使ったり、ソフトウエアをコンパイルするなら、
<literal>maxusers</literal> は最低 4 にして下さい。
@ -650,8 +663,37 @@ pseudo-device loop # Network loopback</programlisting>
<para>以下に続くすべては大体において追加設定項目です。
詳細は各項目の次に書かれている注意書きを参照して下さい。</para>
<programlisting>#makeoptions DEBUG=-g #Build kernel with gdb(1) debug symbols
options MATH_EMULATE #Support for x87 emulation</programlisting>
<programlisting>#To statically compile in device wiring instead of /boot/device.hints
#hints "GENERIC.hints" #Default places to look for devices.</programlisting>
<para>&os; 5.x、およびそれより新しいバージョンでは、
デバイスドライバのオプションは &man.device.hints.5;
を用いて設定されます。
&man.loader.8; は、起動時にデフォルトで
<filename>/boot/device.hints</filename> を確認します。
<literal>hints</literal> オプションを用いると、
カーネルにこれらのヒント情報を静的に加えてコンパイルできます。
その場合には、<filename>/boot</filename> に
<filename>device.hints</filename>
ファイルを作成する必要はありません。</para>
<!-- XXX: Add a comment here that explains when compiling hints into the kernel is a good idea and why. -->
<programlisting>#makeoptions DEBUG=-g #Build kernel with gdb(1) debug symbols</programlisting>
<para>インストール先のディスク容量を節約するため、
通常の &os; のビルド過程ではデバッグ情報は含まれません。
また、作成されたカーネルをリンクした後で、ほとんどのシンボル情報は削除されます。
もし、-CURRENT ブランチにあるカーネルをテストしようとしている、
または自分で変更した &os; カーネルをテストしたいのであれば、
この行のコメントをはずしてください。
&man.gcc.1; の <option>-g</option> オプションを有効にし、
デバッグ情報を生成するようにします。
古い手順 (config; make depend; ...) でカーネルを構築する場合には、
&man.config.8; の <option>-g</option>
オプションを用いて同様のことができます。</para>
<programlisting>options MATH_EMULATE #Support for x87 emulation</programlisting>
<para>この行では、あなたのコンピュータが浮動小数点演算コプロセッサを
持たない場合(CPU が 386 又は 486SX)、
@ -712,7 +754,7 @@ options FFS_ROOT #FFS usable as root device [keep this!]</programli
<programlisting>options UFS_DIRHASH #Improve performance on big directories</programlisting>
<para>このオプションは、メモリを多少余分に食うものの、
大きなディレクトリに対するディスク操作を高速化するコードを有効にします。
大きなディレクトリに対するディスク操作を高速化する機能を有効にします。
大規模なサーバや対話的なワークステーションではこのオプションを残しておいて、
ファイアウォールのように、メモリが貴重で
ディスクアクセス速度がそれほど重要でない
@ -722,12 +764,14 @@ options FFS_ROOT #FFS usable as root device [keep this!]</programli
<para>このオプションは、カーネル内の Soft Updates 機能を有効にし、
ディスクへの高速な書き込みを支援します。
4.X ブランチではデフォルトで有効にされましたが、
有効になっていない可能性もあります。
&man.mount.8; の出力を見て、有効になっているかどうか確認してください。
カーネルがこの機能を提供していても、
特定のディスクに対してはこのオプションを有効にする必要があります。
&man.mount.8; の出力を見て、使用しているディスクで
Soft Updates が有効になっているかどうかを確認してください。
<literal>soft-updates</literal> オプションが見当たらなければ、
&man.tunefs.8; か、新規のファイルシステムについては
&man.newfs.8; で有効にする必要があります。</para>
(現在使用しているファイルシステムには) &man.tunefs.8; や、
(新規のファイルシステムには) &man.newfs.8;
コマンドで有効にする必要があります。</para>
<programlisting>options MFS #Memory Filesystem
options MD_ROOT #MD is a potential root device</programlisting>
@ -961,6 +1005,13 @@ options _KPOSIX_PRIORITY_SCHEDULING</programlisting>
これは PCI カードの自動検出と PCI から ISA バスへのゲートウエイを
可能にします。</para>
<programlisting>device agp</programlisting>
<para>システムが AGP カードを搭載している場合には、
この行を含めてください。
これにより AGP および (これらの機能をボードが持っている場合には)
AGP GART に対応します。</para>
<programlisting># Floppy drives
device fdc0 at isa? port IO_FD1 irq 6 drq 2
device fd0 at fdc0 drive 0