--- nono/doc/index.php 2026/04/29 17:04:48 1.1.1.6
+++ nono/doc/index.php 2026/04/29 17:04:57 1.1.1.9
@@ -39,28 +39,34 @@ function get_version($filename)
ビルドには以下が必要です。
NetBSD(pkgsrc) なら wxWidgets は pkgsrc/x11/wxGTK30 です
-(OPTIONS:gtk2 で動作確認しています)。
+(OPTIONS:gtk3 で動作確認しています)。
The followings are required for build.
If you use NetBSD(pkgsrc),
-wxWidgets is pkgsrc/x11/wxGTK30 (Only OPTIONS:gtk2 is tested).
+wxWidgets is pkgsrc/x11/wxGTK30 (OPTIONS:gtk3 is tested).
-アーカイブを展開したら以下のようにビルドします。
+nono のソースアーカイブを展開したら以下のようにビルドします。
configure には環境変数 CC、CXX でコンパイラを指定することが出来ます。
また wx-config が標準的な名前で提供されていないために見付けられない場合には
環境変数 WX_CONFIG にパスを指定することが出来ます。
-Extract the archive and build as following.
+Extract the nono's source archive and build as following.
You can specify C/C++ compiler using environment variable CC and CXX
if configure cannot find standard name suitable compiler.
Also, you can specify wx-config path using environment variable WX_CONFIG
@@ -113,12 +119,13 @@ if configure cannot find wx-config.
nono が GUI 版実行ファイル、
nono-cli がコマンドライン版です。
Two executables will be installed.
-nono is GUI executable and nono-cli is
-command line executable.
+nono is the GUI executable and nono-cli is
+the command line executable.
+
VM の設定ファイルはその VM ディレクトリ内の nono.cfg
@@ -334,11 +343,26 @@ This field is mandatory.
| | luna | … LUNA-I
- |
| luna88k | … LUNA88K (experimental)
+ |
| luna88k | … LUNA88K
|
_EOM_
);
+config_item("clock-sync =
value", <<<_EOM_
+仮想マシン内の時刻の同期方法を指定します。
+
real なら実時間に同期、
virtual なら仮想時間に同期します。
+デフォルトは
real です。
+この機能は実験中のため将来予告なく仕様が変更になる可能性があります。
+
Specify how to synchronize the time in virtual machine.
+If real, synchronize with the real time;
+if virtual, synchronize with the virtual time.
+The default is real.
+This feature is under experimentation and may be changed in the future
+without notice.
+
+_EOM_
+);
+
config_item("debugger-port =
integer", <<<_EOM_
デバッガの TCP 待ち受けポート番号を指定します。
0 なら待ち受けを行いません。
@@ -349,36 +373,85 @@ The default is 0.
_EOM_
);
-config_item("ethernet-hostdriver =
string", <<<_EOM_
+config_item("ethernet-macaddr =
string", <<<_EOM_
+イーサネットデバイスの仮想マシン側の MAC アドレスを指定します。
+
XX:XX:XX:XX:XX:XX
+形式で指定します。
+
auto なら自動的に決定します。
+デフォルトは
auto です。
+_EOM_
+);
+
+config_item("hostnet-driver =
string", <<<_EOM_
イーサネットデバイスのホスト側ドライバを指定します。
-
none、
tap、
bpf が指定できます。
+
afpacket、
bpf、
tap のうち
+ホスト OS がサポートしているものと
auto、
none が選択可能です。
+
afpacket は Linux の AF_PACKET ソケットを使用します。
+
bpf は bpf(4) デバイスを使用します。
+
tap は tap(4) インタフェースを使用します。
none ならホスト側とは一切通信を行いません。
-
tap か
bpf かはホスト OS によってビルド時に決定します。
-NetBSD、OpenBSD、FreeBSD、Linux なら
tap です。
+
auto ならホスト OS がサポートしているもののうち
+
tap →
afpacket →
bpf を順に試します。
+デフォルトは
auto です。
Specifies the host driver of ethernet device.
-none, tap and bpf can be specified.
-If none, it doesn't make any communication with the host.
-tap or bpf is determined at build time for the host OS.
-If the host is NetBSD, OpenBSD, FreeBSD, or Linux, it's tap.
+
afpacket,
bpf, and
tap can be specified
+only if the host OS supports them.
+
auto and
none can always be specified.
+
afpacket uses Linux's AF_PACKET socket,
+
bpf uses bpf(4) device,
+and
tap uses tap(4) interface.
+
none doesn't make any communication with the host.
+If
auto is specified,
+it tries
tap,
afpacket, and
bpf in that order
+(if the host OS supports them).
+The default is
auto.
_EOM_
);
-config_item("ethernet-hostdevice =
string", <<<_EOM_
-イーサネットデバイスのホスト側のデバイス名を指定します。
-
ethernet-hostdriver が
tap の場合ここには
-tap デバイスを(フルパスで)指定します。
-
Specifies the host device name of ethernet device.
-If ethernet-hostdriver is tap,
-this field specifies the full path to the tap device.
-
-デフォルトは auto で、この場合の動作はホスト OS ごとに異なります。
-Linux なら "/dev/net/tun" を指定したのと同じです。
+config_item("hostdriver-afpacket-ifname = ifname", <<<_EOM_
+ホストドライバが afpacket の時にバインドするインタフェースを1つ指定します。
+ifname が auto
+なら使用可能なインタフェースを1つ自動的に選択します。
+デフォルトは auto です。
+なお、このホストドライバではローカルホストとの通信は出来ません。
+Specify an interface name to bind to, when the host driver is afpacket.
+If auto is specified as ifname,
+it selects an usable interface automatically.
+The default is auto.
+Note that this host driver cannot communicate with the localhost.
+_EOM_
+);
+
+config_item("hostdriver-bpf-ifname = ifname", <<<_EOM_
+ホストドライバが bpf の時にバインドするインタフェースを1つ指定します。
+ifname が auto
+なら使用可能なインタフェースを1つ自動的に選択します。
+デフォルトは auto です。
+なお、このホストドライバではローカルホストとの通信は出来ません。
+Specify an interface name to bind to, when the host driver is bpf.
+If auto is specified as ifname,
+it selects an usable interface automatically.
+The default is auto.
+Note that this host driver cannot communicate with the localhost.
+_EOM_
+);
+
+config_item("hostdriver-tap-devpath = path", <<<_EOM_
+ホストドライバが tap の時に使用するデバイスを1つフルパスで指定します。
+デフォルトは auto で、この場合は自動的にデバイスを選択します。
+この時の探し方はホスト OS によって異なります。
+Linux なら /dev/net/tun を指定したのと同じです。
OpenBSD なら /dev/tap0 から /dev/tap9 まで
順番にオープンできるまで試します。
NetBSD (と FreeBSD) ならまず /dev/tap でクローニングを試み、
それが失敗すれば /dev/tap0 から /dev/tap9 までを
順番にオープンできるまで試します。
-The default is auto.
+いずれの場合も VM ディレクトリかその親ディレクトリに
+nono-ifup, nono-ifdown という名前のシェルスクリプトが必要です。
+何もすることがない場合でも正常終了する空のシェルスクリプトを用意してください。
+
+Specify a device pathname, when the host driver is tap.
+The default is auto.
The behavior in this case depends on the host OS.
On Linux, it's the same as /dev/net/tun.
On OpenBSD, it will try from /dev/tap0 to /dev/tap9
@@ -386,16 +459,62 @@ until successful.
On NetBSD (and FreeBSD), it will try cloning by /dev/tap first.
If that fails, then try from /dev/tap0 to /dev/tap9
until successful.
+In all cases, you need to prepare two shell script files which names are
+nono-ifup and nono-ifdown in the VM directory or
+its parent directory.
+Even if you don't have anything to do in these scripts,
+you need to prepare empty scripts that will terminate successfully.
_EOM_
);
-config_item("ethernet-macaddr = string", <<<_EOM_
-イーサネットデバイスの仮想マシン側の MAC アドレスを指定します。
-XX:XX:XX:XX:XX:XX
-形式で指定します。
-auto なら自動的に決定します。
-デフォルトは auto です。
+config_item("hostnet-fallback = integer", <<<_EOM_
+hostnet-driver で指定したドライバが使用可能でなかった時、
+0 ならプロセスを終了します。
+1 なら none を選択して実行を継続します。
+デフォルトは 0 です。
+Specify the behavior when the driver which is selected by
+hostnet-driver is unusable;
+terminate the process if 0,
+or continue to run using the none driver if 1.
+The default is 0.
+_EOM_
+);
+
+config_item("luna-adjust-misused-epoch = integer", <<<_EOM_
+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 などで時刻修正を行わなかった時
+だけだと思います。
+このオプションはほぼ開発者向けの動作確認用です。
_EOM_
);
@@ -468,6 +587,21 @@ _EOM_
/* luna には不要
config_item("mpu-has-fpu", ""); */
+config_item("mpu-pseudo-stop = integer", <<<_EOM_
+m88100 にて疑似 STOP 状態を有効にするかどうかを指定します。
+0 なら無効(実機と同じ動作)、1 なら有効で、デフォルトは 1 です。
+m88100 には、m68k の STOP 命令 (割り込みが上がるまで何もせず待つ)
+に相当する命令がなく、
+大抵ビジーウェイトループで割り込みが上がるのを待つことになります。
+これは実機では (消費電力を減らす手段がないという些細な問題以外には)
+何のデメリットもないのですが、
+エミュレータで特に高速動作させている時には割り込みが上がるまで
+(例えば人間がキーを入力するまで) ホスト CPU パワーを使い潰してビジーウェイトループを実行し続けることになり、ホスト CPU があっつあつになります。
+それを防ぐための機能です。
+特徴的な命令列を検出して実現しているので、すべての状況で動作するわけではありません。
+_EOM_
+);
+
config_item("prom-image = path", <<<_EOM_
LUNA-I/LUNA88K の外部 ROM イメージファイルのパスを指定します。
path がファイル名のみなら VM ディレクトリとその親ディレクトリからこのファイル名を検索します。
@@ -484,11 +618,10 @@ If the path is empty, internal em
The default value is empty.
実機を持っていない場合はこの値を空に (= デフォルトのままに) しておくと、
-nono 内蔵のなんちゃって下位互換 ROM で起動します(現状 LUNA-I のみ)。
+nono 内蔵のなんちゃって下位互換 ROM で起動します。
If you does not have the real LUNA machines,
you can boot with nono's internal downward compatible emulated ROM
if you set this field empty (or leave it as the default).
-For now, it's only for LUNA-I.
LUNA-I 実機を持っている場合は
@@ -505,11 +638,11 @@ I have no idea about other ROMs.
LUNA88K 実機の場合は 0x41000000-0x4103ffff (256KB) を保存したものです。
-ただし現状サポートしていません。
+今のところ ROM は version 1.20 のみサポートしています。
For LUNA88K,
the ROM file is extracted from 0x41000000-0x4103ffff (256KB).
-However, it's not supported yet.
+For now, only version 1.20 is supported.
_EOM_
);
@@ -535,32 +668,62 @@ If larger, you can specify up to tentati
_EOM_
);
-config_item("spc0-idN-image = devtype,path", <<<_EOM_
-SCSI デバイスを指定します。N には 0 から 7 が入ります。
-ID 7 は本体が使用しますので指定しないでください。
-値はデバイス種別 devtype とイメージパス path
-を ","(カンマ) で区切って並べた形式で、
-今の所デバイス種別 devtype には "hd"(ハードディスク) のみ指定可能です。
-ディスクイメージパスが相対パスなら VM ディレクトリからの相対パスになります。
+config_item("show-statuspanel = integer", <<<_EOM_
+ステータスパネルを表示するかどうかを指定します。
+0 なら非表示、1 なら表示です。
+起動後はメニューから変更可能です。
+Specifies whether to display the status panel or not.
+If 0, it is hidden; if 1, it is shown.
+You can change it on GUI menu after boot.
+
+_EOM_
+);
+
+config_item("spc0-idN-image = devtype[,path]", <<<_EOM_
+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
_EOM_
);
@@ -579,15 +742,15 @@ but this feature is still unstable.
_EOM_
);
-config_item("spc0-idN-writeprotect = integer", <<<_EOM_
-指定の SCSI デバイスへの書き込みを無視するかどうか指定します。
+config_item("spc0-idN-writeignore = integer", <<<_EOM_
+指定の 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
@@ -598,46 +761,158 @@ 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).
_EOM_
);
-
+config_item("spc0-idN-writeprotect = integer", <<<_EOM_
+古いオプションです。
+代わりに spc0-idN-writeignore を使ってください。
+このオプションは開発用です。
+Obsolete.
+Use spc0-idN-writeignore instead.
+This option is for developers.
+
+_EOM_
+);
?>
+
+LUNA では、キーボードがハードウェア側でキーリピートを行わず、
+ソフトウェア(OS など)がキーリピートの処理を行います。
+そのため、キーリピートを実装していない LUNA の PROM や
+NetBSD/luna68k のブートローダではキーリピートは起きず、
+キーリピートを実装している NetBSD/luna68k カーネルではキーリピートが起こせます。
+キーリピートを起こす間隔をゲストのソフトウェアが測定しているということは、
+VM が高速動作するとキーリピートもそれに合わせて発生することになり、
+これをホスト側から防ぐ手段はありません。
+そこで nono ではキー入力が発生している間
+(キーが一つでも押されてからキーが全て離されるまでの間)、
+高速モードが指示されていても VM を一時的に等速モードに落として実行します。
+上記のアイコンがそれを区別しているのはこのためです。
+そのため、何らかの理由でキーが入りっぱなしになった場合
+(ALT + TAB やアクセラレータキーでメニューを開くと起きがちです)
+高速モードが抑制されたままということが起きえます。
+その場合はソフトウェアキーボードからキー入力を解除するなどしてください。
+
+On LUNA,
+key repeat is done by software(OS), not by the keyboard hardware.
+For this reason,
+key repeat doesn't occur on LUNA's PROM or NetBSD/luna68k's bootloader
+that don't implement it, and
+key repeat occurs on NetBSD/luna68k kernel that implements it.
+Since the timing of key repeat is measured by the guest software,
+if the VM is running faster than the real,
+the key repeat will occur faster, too.
+The host application doesn't have the way to avoid it.
+Therefore, nono will temporarily suppress the full speed mode
+while any keys are pressed.
+That is why the above-mentioned icon distinguishes them.
+If keys continue to be pressed for some reasons,
+the VM also continues to run syncronized mode.
+In this case, you can resolve it by using the software keyboard window.
+
+
+
+
+