--- nono/doc/index.html 2026/04/29 17:04:54 1.1.1.9
+++ nono/doc/index.html 2026/04/29 17:04:57 1.1.1.10
@@ -54,7 +54,7 @@ dt.dt-indent {
-
-ver 0.1.x と ver 0.2.0 には2つの非互換があり、そのままでは以前と同じ動作はしません。
-
There are two incompatibilities between ver 0.1.x and ver 0.2.0,
-so it will not work the same as before.
-
-
-- 1. 設定ファイルのネットワーク関連項目の変更
-
Configuration changes about network
- - ver 0.1.x の以下の2つの設定項目は廃止になりました。
-
These two items in 0.1.x have been removed.
-
-
-ethernet-hostdriver = (default: none)
-ethernet-hostdevice = (default: auto)
-
-代わりに次の5つが追加されています。
-設定方法はこのドキュメントの設定の章を参照してください。
-ホストドライバは以前はデフォルトでオフでしたがデフォルトでオン(auto)に変更になっています。
-Instead, the following five items have been added.
-See Configuration section in this document
-to setup.
-The host driver used to be disabled by default before,
-but now it is enabled(auto) by default.
-
-hostnet-driver = (default: auto)
-hostnet-afpacket-ifname = (default: auto)
-hostnet-bpf-ifname = (defualt: auto)
-hostnet-tap-devpath = (default: auto)
-hostnet-fallback = (default: 0)
-
-
-
-- 2. LUNA88K の NVRAM サポートについて
About NVRAM in LUNA88K
- -
-LUNA88K では本来 PROM が NVRAM の情報を元に起動先を決定しますが、
-nono ver 0.1.x は NVRAM を (ファイルを作るだけで) 一切サポートしておらず、
-OpenBSD/luna88k を起動するために起動先ファイル名を boot と決め打ちしていました。
-ver 0.2.0 で NVRAM をサポートしたため、
-内蔵互換 ROM で起動するとまず NVRAM がチェックサム不正のため初期化されます。
-更に初期化された NVRAM の起動ファイル名は vmunix であるため、
-そのままでは OpenBSD/luna88k を起動できません。
-Emulated ROM Monitor が起動したら以下のように入力してください。
-
On LUNA88K, originally PROM determines the boot target by referring NVRAM.
-Since nono ver 0.1.x didn't support NVRAM (though it created NVRAM.DAT file),
-it used hard-coded boot filename "boot" in order to boot OpenBSD/luna88k.
-nono ver 0.2.0 supports NVRAM, so at first it initializes the NVRAM
-due to checksum mismatch.
-In addition, the boot filename in the initialized NVRAM is "vmunix",
-so it cannot boot OpenBSD/luna88k.
-To boot it, enter as following on Emulated ROM Monitor.
-
-nvram boot_filename boot[Enter]
-y
-b[Enter]
-
-この内容は NVRAM.DAT に記録されるので次回以降は直接 OpenBSD が起動します。
-The information you have just entered is recorded in the NVRAM,
-so next time it boots OpenBSD automatically.
-
-
@@ -158,7 +97,7 @@ For clang, 7.0 and 8.0 works at least.)
(NetBSD 以外でのビルドはサポートしていませんが)
-Ubuntu 18.04 ではたぶん以下のパッケージが必要です。
+Ubuntu 20.04 ではたぶん以下のパッケージが必要です。
You may need the following packages on Ubuntu 18.04
(though we won't support non-NetBSD platform).
@@ -170,7 +109,7 @@ gettext
libbsd-dev
libedit-dev
libkqueue-dev
-libwxgtk3.0-dev
+libwxgtk3.0-gtk-dev
zlib1g-dev
@@ -207,24 +146,6 @@ the command line executable.
コマンドラインオプション Command Line Option
-- -A file
-- ホストの file をロードして実行します。
-file が相対パスの場合カレントディレクトリからのパスになります。
-ファイルが gzip 圧縮されていれば自動的に展開します。
-(展開後の) ファイル形式は a.out (OMAGIC) か ELF で、
-実際にはブートローダとカーネル程度しか想定していません。
-設定ファイルの prom-image とともに指定されると
--A のほうが優先します。
-
Loads and executes host's file.
-If file is relative path,
-it is path from the current directory.
-If the file is gzip'd, it is automatically extracted.
-The supported file format (after extracting) is a.out (OMAGIC) or ELF.
-Actually, it only assumes bootloaders or kernels.
-If this option is specified at the same time as
-prom-image in configuration file,
-this option preceeds.
-
- -c vmpath
- VM ディレクトリ/設定ファイルを指定します。
vmpath がディレクトリならそのディレクトリの中の nono.cfg
@@ -291,6 +212,24 @@ parsing -V options.
Use this name=value
instead of name=configvalue specified in configuration file.
+- -X file
+- ホストの file をロードして実行します。
+file が相対パスの場合カレントディレクトリからのパスになります。
+ファイルが gzip 圧縮されていれば自動的に展開します。
+(展開後の) ファイル形式は a.out (OMAGIC) か ELF で、
+実際にはブートローダとカーネル程度しか想定していません。
+設定ファイルの prom-image とともに指定されると
+-X のほうが優先します。
+
Loads and executes host's file.
+If file is relative path,
+it is path from the current directory.
+If the file is gzip'd, it is automatically extracted.
+The supported file format (after extracting) is a.out (OMAGIC) or ELF.
+Actually, it only assumes bootloaders or kernels.
+If this option is specified at the same time as
+prom-image in configuration file,
+this option preceeds.
+
以下開発用。
For developers:
@@ -457,6 +396,40 @@ you need to prepare empty scripts that w
terminate the process if 0,
or continue to run using the
none driver if 1.
The default is 0.
+
luna-adjust-misused-epoch = integer
+
LUNA で誤った RTC epoch を採用している OS 向けに RTC
+エミュレーションを補正するかどうかを
+指定します。0 なら補正をしません(実機と同じ動作)、
+1 なら補正します(現実世界と同じ動作)。
+デフォルトは 1 で、通常 1 のままで使用して問題ありません。
+
+Specifies whether nono corrects RTC emulation for OSes
+that adopts wrong RTC epoch on LUNA.
+0 means making no correction
+(this is the same behavior as the actual machine).
+1 means making correction
+(this is the same behavior as the real world).
+The default is 1. Normally, leave it 1.
+
+LUNA で採用している RTC (MK48T02) は2桁で保持している年の値が
+4 で割り切れる年をうるう年とする仕様です。
+ところが NetBSD/luna68k、OpenBSD/luna88k など現存してソースが確認できる OS
+はいずれもこの RTC の年の値を 1970年からの経過年として使用しています
+(LUNA が本来どういう仕様だったのかは分かりませんが、
+異なる OS を起動し直すたびに RTC epoch をずらす運用は考えにくいので
+おそらくすべての OS で同じだと思います)。
+例えば1970年はうるう年ではないため 2月28日の翌日は 3月1日ですが、
+MK48T02 的には 00年であるためうるう年と認識し 2月28日の翌日が2月29日になります。
+このように、実機の RTC は4年のうち約2年間、1日ずれた日付を指しているようです。
+しかしながら、RTC の時刻は OS 起動時に一度読んだ後は基本的に参照しない上、
+今時必要なら NTP で時間を合わせるため、
+実機でも問題が顕在化することはまずないと思います。
+nono の場合は実機と異なり、アプリケーション実行中しか RTC が進まないため、
+補正がない場合の動作が問題になるのは
+nono を起動したまま偶数年の2月末日から日付をまたいで、
+かつ nono を起動したまま OS を再起動して NTP などで時刻修正を行わなかった時
+だけだと思います。
+このオプションはほぼ開発者向けの動作確認用です。
luna-dipsw1 = string
本体前面 DIPSW#1-1..#1-8 の内容を指定します。
"0" を DOWN、"1" を UP として、
@@ -591,32 +564,51 @@ If larger, you can specify up to tentati
If 0, it is hidden; if 1, it is shown.
You can change it on GUI menu after boot.
-
spc0-idN-image = devtype,path
-
SCSI デバイスを指定します。N には 0 から 7 が入ります。
-ID 7 は本体が使用しますので指定しないでください。
-値はデバイス種別 devtype とイメージパス path
-を ","(カンマ) で区切って並べた形式で、
-今の所デバイス種別 devtype には "hd"(ハードディスク) のみ指定可能です。
-ディスクイメージパスが相対パスなら VM ディレクトリからの相対パスになります。
+spc0-idN-image = devtype[,path]
+
SCSI デバイスとイメージを指定します。キーの N には 0 から 7 が入ります。
+ただし ID 7 は本体が使用しますので指定しないでください。
+値はデバイス種別 devtype とディスクイメージパス path
+を ","(カンマ) で区切って並べた形式です。
+デバイス種別 devtype は以下のいずれかです。
-Specifies SCSI device. N is 0 to 7.
+Specifies SCSI device and image. N in the key is 0 to 7.
But don't specify ID 7 because the host uses it.
The value is in a form of device type devtype and
-the image path path separated by ","(comma).
-For now, only "hd" (hard disk) can be specified for devtype.
+the disk image path path separated by ","(comma).
+devtype can be one of the following:
+
+
+- hd … HD drive
+
- cd … CD-ROM drive
+
- mo … MO drive
+
+
+
+devtype が hd なら path は省略できません。
+devtype が cd か mo なら path は省略可能です。
+イメージパスが相対パスなら VM ディレクトリからの相対パスになります。
+
+If devtype is hd, path cannot be ommitted.
+If devtype is cd or mo, path can be ommitted.
If the path is relative path, it is from the VM directory.
-例えば、nono.cfg と同じディレクトリに置いたディスクイメージ luna.img
-を使う場合、
-LUNA では通常 ID 6 をプライマリ HDD に割り当てるのでこんな感じになります。
-For example, if you use disk image luna.img placed in the same
-directory as nono.cfg,
-since LUNA usually assigns ID 6 to the primary HDD,
+例えば、nono.cfg と同じディレクトリに置いた sd0.img を
+起動 HDD ディスクイメージとして使い
+(LUNA では通常 ID 6 をプライマリ HDD に割り当てます)、
+ID 5 に同じディレクトリの install.iso をセットした CD ドライブを、
+ID 4 に起動時メディアなしの MO ドライブを接続する場合は次のようになります。
+For example, if you use a harddisk image sd0.img placed in the same
+directory as nono.cfg
+(LUNA usually assigns ID 6 to the primary HDD),
+ID 5 for CD-ROM drive that loads install.iso in the same directory,
+and ID 4 for MO drive without media on boot,
write as following:
-spc0-id6-image = hd,luna.img
+spc0-id6-image = hd,sd0.img
+spc0-id5-image = cd,install.iso
+spc0-id4-image = mo
spc0-idN-seektime = integer
指定の SCSI HDD の平均シークタイムを msec 単位で指定します。
@@ -629,15 +621,15 @@ Currently, the default value is 0
-
spc0-idN-writeprotect = integer
-
指定の SCSI デバイスへの書き込みを無視するかどうか指定します。
+spc0-idN-writeignore = integer
+
指定の SCSI HD デバイスへの書き込みを無視するかどうか指定します。
0 なら通常動作(書き込みを行う)です。
1 なら書き込みコマンドは成功したように振る舞いますが実際には
ディスクイメージに一切書き戻しません。
fsck を気にせずカーネルのデバッグとかを行いたい場合にはどうぞ。
何が起きるか意味が分からない人は指定しないでください。
デフォルトは 0 です。
-Specifies whether nono ignores writing to SCSI devices.
+Specifies whether nono ignores writing to SCSI HD devices.
0 means normal operation (writes to the devices).
If 1 is specified,
nono will not actually write back to the disk image
@@ -648,7 +640,20 @@ to the actual disk image.
This is useful for kernel debugging because it does not require fsck
after the kernel hangs.
But don't use this flag if you don't understand this paragraph.
-The default value is 0.
+The default value is 0.
+
+ちなみに、メディアを書き込み禁止にしたい場合はこれではなく、
+イメージファイルの書き込み権を落としてください。
+By the way, if you want to make the media write-protected,
+clear the write permission from the image file
+(instead of this setting).
+
spc0-idN-writeprotect = integer
+
古いオプションです。
+代わりに spc0-idN-writeignore を使ってください。
+このオプションは開発用です。
+Obsolete.
+Use spc0-idN-writeignore instead.
+This option is for developers.
@@ -1030,6 +1035,17 @@ It's OK if you can see "HostNet Driver:
See
changes.html.
+
+バージョンアップに伴い設定ファイル等に非互換が発生する場合があります。
+その場合は以下の移行方法を参照して設定ファイル等を更新してください。
+
Some versions may have incompatibilities in the configuration files, etc.
+In such case, you may need to upgrade it by referring the following link.
+
+