From 64adf16f93ec3164a2c37c0c0dcb5910a789279c Mon Sep 17 00:00:00 2001 From: Kazuo Horikawa Date: Mon, 4 Sep 2000 03:54:18 +0000 Subject: [PATCH] Add 4.1-RELEASE based Japanese manuals Submitted by:jsakai@mvg.biglobe.ne.jp --- ja_JP.eucJP/man/man8/Makefile | 2 + ja_JP.eucJP/man/man8/picobsd.8 | 330 +++++++++++++++++++++++++++++++++ ja_JP.eucJP/man/man8/pxeboot.8 | 126 +++++++++++++ 3 files changed, 458 insertions(+) create mode 100644 ja_JP.eucJP/man/man8/picobsd.8 create mode 100644 ja_JP.eucJP/man/man8/pxeboot.8 diff --git a/ja_JP.eucJP/man/man8/Makefile b/ja_JP.eucJP/man/man8/Makefile index ca94f93065..74bc047361 100644 --- a/ja_JP.eucJP/man/man8/Makefile +++ b/ja_JP.eucJP/man/man8/Makefile @@ -171,6 +171,7 @@ MAN8 = IPXrouted.8\ pccardd.8\ pciconf.8\ periodic.8\ + picobsd.8\ ping.8\ ping6.8\ pnpinfo.8\ @@ -186,6 +187,7 @@ MAN8 = IPXrouted.8\ pstat.8\ pw.8\ pwd_mkdb.8\ + pxeboot.8\ quot.8\ quotacheck.8\ quotaon.8\ diff --git a/ja_JP.eucJP/man/man8/picobsd.8 b/ja_JP.eucJP/man/man8/picobsd.8 new file mode 100644 index 0000000000..5884f83593 --- /dev/null +++ b/ja_JP.eucJP/man/man8/picobsd.8 @@ -0,0 +1,330 @@ +.\" -*- nroff-fill -*- +.\" %FreeBSD: src/share/man/man8/picobsd.8,v 1.1.2.1 2000/04/23 16:58:37 mpp Exp % +.Dd 23 December 1999 +.\" jpman %Id: picobsd.8,v 1.3 2000/08/10 13:49:12 horikawa Stab % +.Os FreeBSD +.Dt PicoBSD 8 +.Sh 名称 +.Nm PicoBSD +.Nd フロッピディスクベースの FreeBSD システム +.Sh 書式 +.Nm +は、1 枚ないし数枚のフロッピディスク上に実装した最小限の FreeBSD です。 +フロッピディスクはロードする際にのみ必要です。 +システムは RAMDISK から立ち上り、それゆえフロッピディスクの速度限界に +左右されません。 +.Sh 解説 +1 枚目の +.Nm +フロッピ (これが唯一必須のものです) には、 +圧縮したカーネルと圧縮した MFS ルートファイルシステム、 +それに +.Pa /etc +ディレクトリのいくつかのファイルが含まれます。 +システムはこのカーネルを通常どおりロードし、 +ファイルシステムの圧縮を解凍してルートとしてマウントします。 +続いてフロッピの +.Pa /etc +ディレクトリ内のファイルを MFS の +.Pa /etc +ディレクトリにコピーし、特別なバージョンの +.Pa /etc/rc +を実行します。 +標準版の +.Pa /etc/rc +は追加フロッピを求めるプロンプトを出し、 +それを MFS ファイルシステムに読み込みます。 +.Sh 環境 +サイズ制限が極めて厳しいため、 +.Nm +の環境は通常の FreeBSD といくつかの点で異なっています: +.Bl -bullet +.It +ダイナミックライブラリはなく、 +.Pa /usr/lib +ディレクトリもありません。 +そのため、スタティックリンクした実行体のみ実行可能です。 +.It +実行体のサイズを減らすため、特定のフロッピ内のすべての実行体は、 +.Xr crunchgen 1 +を利用して単一の実行体にまとめられています。 +.It +プログラムによっては最小限のバージョンが提供されています。 +.Nm ns +は +.Nm netstat +の機能限定版であり、 +.Nm vm +は +.Nm vmstat +の機能限定版です。 +.El +.Sh PicoBSD の構築 +.Nm +のソースはディレクトリ +.Pa /usr/src/release/picobsd +の下にあります。 +以下では、相対パス名はすべてこのディレクトリからの相対位置です。 +.Nm +の構築過程は、できるだけ多くのものをフロッピに詰め込めるよう、 +柔軟に設計されています。 +特に、以下のことが可能です: +.Bl -bullet +.It +旧式の構築法では、 +.Pa build/build +と呼ばれるスクリプトを用います。 +このスクリプトを使うには、ディレクトリ +.Pa build/ +に移って +.Cm build +を実行します。 +.Cm build +は対話的なスクリプトで、いくつかパラメータを尋ねた後、 +適切な単一フロッピ版を構築します。 +5 種類のフロッピが想定されています: +.Bl -hang +.It dial +はダイヤルアウト (ppp) ネットワーキングに適したコンフィギュレーションです。 +.It install +はソフトウェアインストールに適したコンフィギュレーションです。 +.It isp +はダイヤルイン (ppp) ネットワーキングに適したコンフィギュレーションです。 +.It net +は一般的なネットワーキングに適したコンフィギュレーションです。 +.It router +はルータとして使う場合に適したコンフィギュレーションです。 +この特別なコンフィギュレーションは、最小限のハードウェアで動作することを +目標としています。 +.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 PicoBSD +を構築する際は、このファイルを注意してチェックすることが重要です。 +最も小さなカーネルは圧縮後で約 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 ファイルです。 +この形式で、任意のスタティックリンクプログラムをフロッピに入れることができ、 +スタートアップルーチンは自動的にそれを読み込みます。 +ダイナミックライブラリは存在しないことにくれぐれもご注意。 +プログラムはスタティックでなければなりません。 +.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 +.Sh PicoBSD のブート +.Nm PicoBSD +をブートするには、フロッピを挿入してマシンをリセットします。 +ブート手順は標準の FreeBSD ブートと似ていますが、 +非常にゆっくりと進みます。 +POST (BIOS の Power On Self Test) が終ってから +2 枚目フロッピを求めるプロンプトが出るまで 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 +を生成します。 +.Ss スワップ空間 +ブート後は、 +.Nm +は完全に MFS ファイルシステム上で走ります。 +もはやフロッピは不要ですし、 +たとえ +.Nm +カーネルにハードディスクドライバが含まれていても、 +.Nm +はハードディスクにアクセスしません。 +特に、スワップ空間もありませんので、 +メモリ不足の際には予期できない事態が発生し得ます。 +.Pp +もしディスクドライバがあって、 +スワップパーティションを含むディスクがあり、 +しかもそのスワップパーティションに +保存しておきたいダンプが含まれていないなら、 +そのスワップを +.Nm PicoBSD +で使用することも可能です。 +.Xr swapon 8 +コマンドを使って下さい。 +.Sh クラッシュしたシステムの回復 +.Em カスタム +.Nm +コンフィギュレーションには +.Em fixit +フロッピにあるすべてのプログラムが含まれますので、 +fixit フロッピの代わりにカスタム +.Nm +を使用することができます。 +.Sh 関連項目 +.Xr crunchgen 1 , +.Xr swapon 8 , +.Xr vnconfig 8 +.\" .Sh STANDARDS +.\" .Sh HISTORY +.Sh 作者 +.An Andrzej Bialecki Aq abial@FreeBSD.org +です。 +マニュアルページと Makefile の作成は +.An Greg Lehey Aq grog@lemis.com +が行いました。 +.Sh バグ +.Nm PicoBSD +を構築する際、 +構築作業を行うシステムのカーネルには +.Nm vn +ドライバがインストールされていなければなりません。 +.Pp +構築の過程は +.Nm root +で実行しなければなりません。 +.Pp +構築の過程では未使用 vnode デバイスの検索は行いません。常に +.Pa /dev/vn0 +と +.Pa /dev/vn1 +を使用します。 +もしこれらのファイルが他のプログラムで使用中なら、 +予測できない結果になるかもしれません。 +.Pp +.Nm +の構築には、依然、中身の見えにくいところがあります。 +最大の問題は、 +どういうふうにすればフロッピにぴったり詰め込むことができるかを +判断することです。 +現実的な方法は試行錯誤しかありません。 +.Pp +オリジナル版の +.Nm +は 1 枚のフロッピにちょうと収まります。 +FreeBSD 4.0 以降、カーネルが大変大きくなったため、 +ほとんどのコンフィギュレーションでは 2 枚目フロッピがなければ +生産的な作業ができなくなっています。 +しかし、他のプログラムと一緒に 1 枚のフロッピにちょうど収まる +最小限のカーネルを作成することは可能なはずです。 +.Pp +.Xr crunchgen 1 +を使って実行体を作成するアプローチにより、 +異なるフロッピ間にライブラリの重複が相当発生することになります。 +.Pp +現時点 (1999 年 12 月) では、 +旧式の構築法は FreeBSD-CURRENT では使えません。 +3.x カーネルに比べ 4.x カーネルのサイズが非常に大きい点からみて、 +この方式が使えるようになるかどうか定かではありません。 +.Pp +.Nm +は 1999 年に少しだめになり、 +現在、ほとんどの旧式コンフィギュレーションでは構築は行えません。 +.Pp +.Nm PicoBSD +上で +.Nm Emacs +を動作させる方法はなさそうです。 diff --git a/ja_JP.eucJP/man/man8/pxeboot.8 b/ja_JP.eucJP/man/man8/pxeboot.8 new file mode 100644 index 0000000000..8d933ed21b --- /dev/null +++ b/ja_JP.eucJP/man/man8/pxeboot.8 @@ -0,0 +1,126 @@ +.\" Copyright (c) 1999 Doug White +.\" All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" %FreeBSD: src/sys/boot/i386/pxeldr/pxeboot.8,v 1.1.2.3 2000/07/06 23:53:25 obrien Exp % +.\" +.\" Note: The date here should be updated whenever a non-trivial +.\" change is made to the manual page. +.Dd May 1, 2000 +.\" jpman %Id: pxeboot.8,v 1.3 2000/07/20 02:26:23 horikawa Stab % +.Dt PXEBOOT 8 +.Os +.Sh 名称 +.Nm pxeboot +.Nd プリブート実行環境 (PXE) ブートローダ +.Sh 解説 +.Nm +は、システムの第 3 段階ブートストラップ +.Xr loader 8 +の修正バージョンであり、 +Intel のプリブート実行環境 (Preboot Execution Environment, PXE) システムで +動作するように構築されたものです。 +PXE は、スマートなブート ROM の形態をとり、 +Intel EtherExpress Pro/100 や 3Com 3c905c イーサネットカード、 +それにイーサネットを装備した Intel マザーボードに組み込まれています。 +PXE は、DHCP コンフィギュレーションをサポートし、 +低レベルの NIC アクセスサービスを提供します。 +.Nm +は、カーネルやモジュールそれに他のファイル群を、 +UDP 上の NFS または TFTP 経由で (これはコンパイル時オプションで選択します) +取り出します。 +.Nm +とメモリファイルシステムイメージ +あるいは NFS マウントしたルートファイルシステムと組み合わせることで、 +ディスクレスマシンを容易に、EEPROM 焼き器なしで構築することができます。 +.Pp +.Nm +バイナリは、DHCP サーバのコンフィギュレーションファイル中に指定することで、 +他のブートファイルと同様にロードされます。 +.\" 1.1.2.3 対応にともない削除 +.\" しかし、PXE がサーバ応答を認識するには特別な DHCP オプションが必要です。 +ISC DHCP v2 サーバ向けのコンフィギュレーションのサンプルを以下に示します: +.Bd -literal -offset indent +option domain-name "example.com"; +option routers 10.0.0.1; +option subnet-mask 255.255.255.0; +option broadcast-address 10.0.0.255; +option domain-name-servers 10.0.0.1; +server-name "DHCPserver"; +server-identifier 10.0.0.1; + +default-lease-time 120; +max-lease-time 120; + +subnet 10.0.0.0 netmask 255.255.255.0 { + filename "pxeboot"; + range 10.0.0.10 10.0.0.254; +} + +.Ed +.Nm +は、ディレクティブ +.Va next-server +および +.Va option root-path +を、サーバおよびファイル要求の NFS マウントパスとしてそれぞれ認識するか、 +あるいは TFTP 要求を送るサーバとして認識します。 +.Nm +は、他のファイルをロードする前に、指定したサーバから +.Pa /boot/loader.rc +を読み込むことを想定していることに注意してください。 +.Pp +その他の点では、 +.Nm +は +.Xr loader 8 +と同じように振舞います。 +.Pp +PXE はまだ成熟したものではないため、ファームウェアのバージョンによっては +正常に動作しない可能性があります。 +.Nm +は Intel ファームウェア version 0.99 上で綿密にテストされましたが、 +より新しい 2.0 ファームウェアのプレリリースバージョンでは +問題があることが判明しています。 +デバイス製造者の最新の安定リリースをチェックしてください。 +.Pp +Intel の PXE 仕様および Wired for Management (WfM) システムに関する +更に詳細な情報については、 +.Li http://developer.intel.com/ial/wfm/ +を参照してください。 +.Sh 関連項目 +.Xr loader 8 +.Sh 歴史 +.Nm +は +.Fx 4.1 +に初めて登場しました。 +.Sh 作者 +.Nm +の作者は +.An John Baldwin Aq jhb@freebsd.org +および +.An Paul Saab Aq ps@freebsd.org +です。このマニュアルページの著者は +.An Doug White Aq dwhite@freebsd.org +です。