picobsd.8 revision 1.1.2.5

1 files changed, 56 insertions, 194 deletions

diff --git a/ja_JP.eucJP/man/man8/picobsd.8 b/ja_JP.eucJP/man/man8/picobsd.8
index bc05611c62..766aeda0a1 100644
--- a/ja_JP.eucJP/man/man8/picobsd.8
+++ b/ja_JP.eucJP/man/man8/picobsd.8
@@ -1,21 +1,25 @@
 .\" -*- nroff-fill -*-
-.\" %FreeBSD: src/share/man/man8/picobsd.8,v 1.1.2.4 2001/03/06 19:08:20 ru Exp %
+.\" %FreeBSD: src/share/man/man8/picobsd.8,v 1.1.2.5 2001/04/21 00:04:29 luigi Exp %
 .Dd December 23, 1999
 .\" jpman %Id: picobsd.8,v 1.3 2000/08/10 13:49:12 horikawa Stab %
 .Os FreeBSD
 .Dt PicoBSD 8
 .Sh 名称
-.Nm PicoBSD
+.Nm picobsd
 .Nd フロッピディスクベースの FreeBSD システム
 .Sh 書式
 .Nm
+.Op Fl n
+.Op Ar floppy-type Op Ar site-name
+.Pp
+.Sh 解説
+.Nm
 は、1 枚ないし数枚のフロッピディスク上に実装した最小限の
 .Fx
 です。
 フロッピディスクはロードする際にのみ必要です。
 システムは RAMDISK から立ち上り、それゆえフロッピディスクの速度限界に
 左右されません。
-.Sh 解説
 1 枚目の
 .Nm
 フロッピ (これが唯一必須のものです) には、
@@ -63,31 +67,25 @@
 .Nm vmstat
 の機能限定版です。
 .El
-.Sh PicoBSD の構築
+.Sh picobsd の構築
 .Nm
 のソースはディレクトリ
 .Pa /usr/src/release/picobsd
 の下にあります。
 以下では、相対パス名はすべてこのディレクトリからの相対位置です。
 .Nm
-の構築過程は、できるだけ多くのものをフロッピに詰め込めるよう、
-柔軟に設計されています。
-特に、以下のことが可能です:
-.Bl -bullet
-.It
-旧式の構築法では、
-.Pa build/build
-と呼ばれるスクリプトを用います。
-このスクリプトを使うには、ディレクトリ
-.Pa build/
-に移って
-.Cm build
-を実行します。
-.Cm build
-は対話的なスクリプトで、いくつかパラメータを尋ねた後、
+の構築過程は、時とともに少し変化しました。
+コード量の不可避な増加に対応するために、
+なるべく多くをフロッピに詰め込むための沢山のからくりが必要となったからです。
+FreeBSD 4.3 では、サポートされている構築スクリプトは
+.Pa /usr/src/release/picobsd/build/picobsd
+であり、どこからでも実行可能です。
+この対話的なスクリプトは、いくつかパラメータを尋ねた後、
 適切な単一フロッピ版を構築します。
-5 種類のフロッピが想定されています:
+次の種類のフロッピが想定されています:
 .Bl -hang
+.It bridge
+はブリッジ、ルータ、ファイアウォールに適したコンフィギュレーションです。
 .It dial
 はダイヤルアウト (ppp) ネットワーキングに適したコンフィギュレーションです。
 .It install
@@ -101,114 +99,36 @@
 この特別なコンフィギュレーションは、最小限のハードウェアで動作することを
 目標としています。
 .El
-.It
-新しい構築法では
-.Cm make
-を使用します。
-ファイル
-.Pa Makefile
-によって
-.Pa custom
-ディレクトリ内で構築が行われます。
-.El
 .Pp
-構築過程には次のステップがあります。
-その中の例ではサブディレクトリ
-.Pa custom 
-が用いられていますが、要点はサブディレクトリ
-.Pa dial ,
-.Pa install ,
-.Pa isp ,
-.Pa net ,
-.Pa router
-にもあてはまります。
-.Bl -hang
-.It Em "カーネルの構築 "
-各ディレクトリには
-.Pa PICOBSD 
-で始まる名前のコンフィギュレーションファイルがあります。
-カスタム
-.Nm
-を構築する際は、このファイルを注意してチェックすることが重要です。
-最も小さなカーネルは圧縮後で約 600 kB の大きさを占めますが、
-ちょっとしたことで 900 kB 程度まで大きくなります。
-900 kB のカーネルで
-1 枚目の
-.Nm
-フロッピを構築することは恐らく不可能です。
-.It Em "MFS イメージの構築"
-1 枚目のフロッピの MFS イメージは
-.Nm vnode
-ファイルシステムとして作られます。このファイルシステムは後に
-.Pa /dev/vn0 
-として
-.Pa custom/mmnt
-にマウントされます。
-.It Em "crunch 版実行体の作成"
-1 枚目フロッピの実行体は
-.Pa crunch/crunch1/ 
-ディレクトリ内で構築されます。
-この実行体の中身はファイル
-.Pa crunch/crunch1/crunch.conf 
-で決定されます。
-.It Em "フロッピイメージの構築"
-後に 1 枚目フロッピとなる 2 つめのファイルシステムイメージが構築され、
-.Pa /dev/vn1
-として
-.Pa custom/fmnt 
-にマウントされます。
-その中には、圧縮したカーネル、圧縮した MFS ファイルシステム、
-ツリー
-.Pa floppy.tree/ 
-、及びもし存在すれば
-.Pa floppy.tree/custom/
-の内容が含まれます。
-この 2 段階の方法により、
-.Pa floppy.tree/custom/ 
-中の特別なファイルによって
-.Pa floppy.tree/ 
-にあるファイルを上書きすることができます。
-.It Em "2 枚目フロッピのイメージの作成"
-最後に、2 枚目のフロッピ用イメージを構築します。
-このフロッピにはただ 1 つのファイルしかありません。
-そのファイルはブート時に MFS 相対ディレクトリの
-.Pa /bin
-にコピーされます。
-その中身は
-.Pa crunch/crunch2/ 
-ディレクトリで構築されます。
-また、この実行体の内容はファイル
-.Pa crunch/crunch2/crunch.conf 
-で決定されます。
-.It Em "フロッピへのデータのコピー"
-以上のステップは
-.Nm make all
-ステップで実行されます。
-.Nm make all
-はデータをフロッピディスクにコピーしません。代わって、
-.Nm make floppy 
-を使って 1 枚目フロッピを、
-.Nm make floppy2
-を使って 2 枚目フロッピを作成します。
-.It Em "追加フロッピの作成"
-理論的には、多数のフロッピを MFS に読み込むことが可能です。
-追加の各フロッピは (2 枚目もそうですが)、
-.Pa /bin 
-相対のファイルを含む、gzip した tar ファイルです。
-この形式で、任意のスタティックリンクプログラムをフロッピに入れることができ、
-スタートアップルーチンは自動的にそれを読み込みます。
-ダイナミックライブラリは存在しないことにくれぐれもご注意。
-プログラムはスタティックでなければなりません。
+これらのコンフィギュレーションは、
+あなた自身による構築の参考のためだけにあります。
+すべてがテストされたわけではありませんし、
+動かすため、もしくはコード量増加時に空きディスク空間に納めるために、
+コンフィギュレーションファイルにちょっとした修正が必要となるかもしれません。
+.Pp
+あなた自身のフロッピタイプを定義可能であり、
+このためには次のものを含む好み (例 FOO) のディレクトリを作成します。
+.Pp
+.Bl -tag -width "floppy.tree.exclude" -compact
+.It PICOBSD
+カーネルコンフィギュレーションファイル (必須)。
+.It crunch.conf
+crunchgen コンフィギュレーションファイル (必須)。
+.It config
+"picobsd" スクリプトが読み取るシェル変数 (省略可能)。
+.It floppy.tree.exclude
+標準フロッピツリーから得る、必須ではないファイル (省略可能)。
+.It floppy.tree/
+標準フロッピツリーへの、ローカルな追加 (省略可能)。
+.It floppy.tree.${site}
+上と同じですが、サイト固有です (省略可能)。
 .El
-.\" .Sh FILES
-.\" .Sh EXAMPLES
-.\" This next request is for sections 1, 6, 7, 8 & 9 only
-.\"     (command return values (to shell) and
-.\"       fprintf/stderr type diagnostics)
-.\" .Sh DIAGNOSTICS
-.\" The next request is for sections 2, 3 and 9 error
-.\" and signal handling only.
-.\" .Sh ERRORS
+
+構築過程に関する更なる情報は、"picobsd" スクリプトに記述されています。
+サンプルのコンフィギュレーションは
+.Pa /usr/src/release/picobsd/${type}/
+にあります。
+
 .Sh PicoBSD のブート
 .Nm
 をブートするには、フロッピを挿入してマシンをリセットします。
@@ -217,28 +137,13 @@
 ブートと似ていますが、
 非常にゆっくりと進みます。
 POST (BIOS の Power On Self Test) が終ってから
-2 枚目フロッピを求めるプロンプトが出るまで 3 分ほどかかります。
+システムが立ち上がって走行するまで 1 〜 3 分かかります。
 .Pp
-追加フロッピを求めるプロンプトが出たら、
-そのフロッピをドライブに挿入してから
-.Em y 
-と答えます。これ以上フロッピがない場合は
-.Em n 
-を入力します。
-このバージョンの
-.Nm
-には root パスワードがありません。
-もし一層のセキュリティを求めるなら、自分の
-.Pa /etc/master.passwd
-と、もし必要なら
-.Pa /etc/group
-も、1 枚目フロッピにコピーすることができます。
-必要なファイルはこの 2 つだけです。
-ブートプロセスは自動的に次のファイル
-.Pa /etc/passwd ,
-.Pa /etc/spwd ,
-.Pa /etc/pwd.db 
-を生成します。
+ブートを高速化するには、
+.Xr etherboot
+を使用して、ロード済みで圧縮を伸長したカーネルイメージをロードしてください。
+このイメージは、picobsd 構築過程で生成されます。
+この場合、10Mbit/s イーサネットでさえ、ロード時間は数秒になります、
 .Ss スワップ空間
 ブート後は、
 .Nm
@@ -261,15 +166,6 @@ POST (BIOS の Power On Self Test) が終ってから
 で使用することも可能です。
 .Xr swapon 8
 コマンドを使って下さい。
-.Sh クラッシュしたシステムの回復
-.Em カスタム
-.Nm
-コンフィギュレーションには
-.Em fixit 
-フロッピにあるすべてのプログラムが含まれますので、
-fixit フロッピの代わりにカスタム
-.Nm
-を使用することができます。
 .Sh 関連項目
 .Xr crunchgen 1 ,
 .Xr swapon 8 ,
@@ -280,6 +176,9 @@ fixit フロッピの代わりにカスタム
 .An -nosplit
 .An Andrzej Bialecki Aq abial@FreeBSD.org
 です。
+スクリプト関連の仕事を
+.An Luigi Rizzo Aq luigi@iet.unipi.it
+等が引き継ぎました。
 マニュアルページと Makefile の作成は
 .An Greg Lehey Aq grog@lemis.com
 が行いました。
@@ -293,14 +192,7 @@ fixit フロッピの代わりにカスタム
 構築の過程は
 .Nm root 
 で実行しなければなりません。
-.Pp
-構築の過程では未使用 vnode デバイスの検索は行いません。常に
-.Pa /dev/vn0
-と
-.Pa /dev/vn1 
-を使用します。
-もしこれらのファイルが他のプログラムで使用中なら、
-予測できない結果になるかもしれません。
+vnconfig と mount を実行する必要があるためです。
 .Pp
 .Nm
 の構築には、依然、中身の見えにくいところがあります。
@@ -308,33 +200,3 @@ fixit フロッピの代わりにカスタム
 どういうふうにすればフロッピにぴったり詰め込むことができるかを
 判断することです。
 現実的な方法は試行錯誤しかありません。
-.Pp
-オリジナル版の
-.Nm
-は 1 枚のフロッピにちょうと収まります。
-.Fx 4.0
-以降、カーネルが大変大きくなったため、
-ほとんどのコンフィギュレーションでは 2 枚目フロッピがなければ
-生産的な作業ができなくなっています。
-しかし、他のプログラムと一緒に 1 枚のフロッピにちょうど収まる
-最小限のカーネルを作成することは可能なはずです。
-.Pp
-.Xr crunchgen 1
-を使って実行体を作成するアプローチにより、
-異なるフロッピ間にライブラリの重複が相当発生することになります。
-.Pp
-現時点 (1999 年 12 月) では、
-旧式の構築法は
-.Fx Ns -CURRENT
-では使えません。
-3.x カーネルに比べ 4.x カーネルのサイズが非常に大きい点からみて、
-この方式が使えるようになるかどうか定かではありません。
-.Pp
-.Nm
-は 1999 年に少しだめになり、
-現在、ほとんどの旧式コンフィギュレーションでは構築は行えません。
-.Pp
-.Nm
-上で
-.Nm Emacs
-を動作させる方法はなさそうです。