--- nono/doc/index.php 2026/04/29 17:04:57 1.1.1.9
+++ nono/doc/index.php 2026/04/29 17:05:56 1.1.1.24
@@ -3,130 +3,192 @@
Copyright (C) 2020 nono project
Licensed under nono-license.txt
-->
- 1)
- get_version($_SERVER['argv'][1]);
-
-function get_version($filename)
+
+
+
+
+
-VM の設定ファイルはその VM ディレクトリ内の nono.cfg
-(または -c で指定したファイル) です。
-書式は
key = value 形式で1行1項目ずつです。
+nono の設定はいずれも以下の順序で適用されます。
+
nono's configurations are always applied in the following order.
+
+- デフォルト値
Default value
+ - ~/.nono.cfg があればその内容
+
Contents of ~/.nono.cfg if exists
+ - VM ディレクトリ内の nono.cfg (または -c で指定したファイル)
+があればその内容
+
Contents of nono.cfg in the VM directory (or the file specified by -c option) if exists
+ - コマンドラインオプション
Command line option
+
+ファイルの書式はどちらも
key = value 形式で1行1項目ずつです。
key と
value の前後の空白は取り除かれます。
また空行と "
#" で始まる行は無視します。
-知らないキーの行も無視します。
-
VM configuration file is nono.cfg
-(or the file specified by -c option) in the VM directory.
-Its syntax is key = value format, one per line.
+知らないキーは警告を出した上で無視します。
+同じキーが複数回現れた場合、
+上に列挙した順に後から書いたほうで上書きし、
+同じファイル内でも同様に後に書いたほうで上書きします。
+コマンドラインオプション -V 等はこれをさらに上書きします。
+コマンドラインオプションで同じキーが複数回現れた場合も後に書いたほうが上書きします。
+
+The syntax of both files is key = value format, one per line.
White spaces before and after key and value are ignored.
-And, blank lines, lines beginning with "#", and
-lines with unrecognized key are also ignored.
-
+Blank lines, lines beginning with "#" are also ignored.
+The lines with unrecognized key are ignored with a warning.
+
+If the same key appears more than once,
+the latter overwrites the former in the above order.
+If the same key appears in a file,
+the latter overwrites the former in the same manner.
+Then, command line option -V etc. overwrites them.
+If the same key appears more than once in the command line option,
+do in the same manner.
+
+vmtype を除くすべての設定項目はそれぞれデフォルト値を持っています。
+つまり少なくとも vmtype だけは設定ファイルかコマンドラインオプションで指定する必要があります。
+All configuration items except vmtype have default value.
+It means, you need to specify at least only vmtype
+by configuration file or commandline option.
設定項目は次の通りです。
The configuration items are:
@@ -339,82 +495,502 @@ config_item("vmtype = string", <<
VM 種別を以下のいずれかから指定します。
省略不可です。
Specifies the VM type from the following.
-This field is mandatory.
-
+This field is mandatory.
-| | luna | … LUNA-I
- |
| luna88k | … LUNA88K
+ |
| | luna | … LUNA-I
+ |
| luna88k | … LUNA-88K
+ |
| x68030 | … X68030
+ |
| news | … NWS-1750 (Just a joke)
+ |
| virt-m68k (or virt68k) | … virt-m68k
|
_EOM_
);
+config_item("cgrom-image =
path", <<<_EOM_
+(X68030 Only)
+X68030 の外部 CGROM イメージファイルのパスを指定します。
+CGROM は 768KB です。
+
path がファイル名のみなら VM ディレクトリとその親ディレクトリからこのファイル名を検索します。
+
path が相対パスなら VM ディレクトリからの相対パスになります (現在のディレクトリからではありません)。
+空にすると nono 内蔵の互換 CGROM を使用します。
+デフォルトは空です。
+
Specifies the X68030's external CGROM image file path.
+This CGROM is 768KB.
+If the path does not have any path delimiters,
+the VM directory and then its parent directory will be searched.
+If the path is a relative path,
+it will be path from the VM directory, not from the current directory.
+If the path is empty, nono's builtin compatible CGROM will be used.
+The default value is empty.
+_EOM_
+);
+
config_item("clock-sync =
value", <<<_EOM_
仮想マシン内の時刻の同期方法を指定します。
real なら実時間に同期、
virtual なら仮想時間に同期します。
+
Specifies how to synchronize the time in the virtual machine.
+real means synchronizing with the real time.
+virtual means synchronizing with the virtual time.
+
+- LUNA-I では 60Hz のシステムクロック割り込みと RTC(MK48T02) が対象で、
デフォルトは 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.
-
+On LUNA-I, 60Hz system clock interrupt and RTC(MK48T02) are the target.
+The default is real.
+ - LUNA-88K では 100Hz のシステムクロック割り込みと RTC(MK48T02) が対象で、
+デフォルトは real です。
+
On LUNA-88K, 100Hz system clock interrupt and RTC(MK48T02) are the target.
+The default is real.
+ - NWS-1750 ではシステムクロック割り込みと RTC(MK48T02) が対象で、
+デフォルトは real です。
+
On NWS-1750, system clock interrupt and RTC(MK48T02) are the target.
+The default is real.
+ - virt-m68k では Goldfish Timer の割り込みと Goldfish RTC が対象で、
+デフォルトは real です。
+
On virt-m68k, Goldfish Timer interrupt and Goldfish RTC are the target.
+The default is real.
+ - X68030 では MFP のタイマー割り込みと RTC(RP5C15) が対象で、
+デフォルトは virtual です。
+MFP の TxDR レジスタの読み出しは、
+この指定に関わらず常に virtual 相当の動作しか出来ません。
+NetBSD/x68k での時間同期 の項も参照してください。
+
On X68030, MFP timer interrupts and RTC(RP5C15) are the target.
+The default is virtual.
+Note that reading from MFP TxDR register only works as virtual,
+regardless of this setting.
+See also Time Synchronization on NetBSD/x68k.
+
_EOM_
);
-config_item("debugger-port =
integer", <<<_EOM_
-デバッガの TCP 待ち受けポート番号を指定します。
-0 なら待ち受けを行いません。
-デフォルトは 0 です。
-
Specifies the TCP port number that debugger listens.
-If 0, it will not listen.
-The default is 0.
+config_item("debugger-driver =
string", <<<_EOM_
+デバッガのコンソールドライバを指定します。
+
stdio、
tcp、
none が選択可能です。
+
stdio は標準入出力を使用します。
+
tcp は TCP ポートで TELNET プロトコルで待ち受けます。
+
none ならホスト側とは一切通信を行いません。
+デフォルトは
none です。
+
Specifies console driver of the debugger.
+stdio, tcp, and none can be specified.
+stdio uses the standard input/output.
+tcp listens on TCP port using TELNET protocol.
+none doesn't make any communication with the host.
+The default is none.
+_EOM_
+);
+
+config_item("debugger-tcp-port =
integer",
+<<<_EOM_
+デバッガのコンソールドライバが tcp の時の TCP 待ち受けポート番号を指定します。
+
Specifies the TCP port number that debugger console driver listens.
_EOM_
);
-config_item("ethernet-macaddr =
string", <<<_EOM_
-イーサネットデバイスの仮想マシン側の MAC アドレスを指定します。
+?>
yesno", <<<_EOM_
+(LUNA and NEWS Only)
+機種に依存せず DIPSW を自動起動に設定するかどうか指定します。
+"
yes" なら自動起動するように、
+"
no" なら自動起動しないように DIPSW 設定を上書きします。
+"" (空) なら何もしません。デフォルトは "" です。
+このオプションは
luna-dipsw1 や
news-dipsw
+の状態が設定ファイルやコマンドラインオプションによって確定した後に
+該当のスイッチだけを変更します。
+
Specifies whether to configure DIPSW to boot automatically,
+regardless of the models.
+"yes" overwrites DIPSW, to boot automatically.
+"no" overwrites DIPSW, not to boot automatically.
+"" (Empty) does nothing.
+The default value is "".
+This option only changes the appropriate switch(es)
+after the luna-dipsw1 or news-dipsw configuration
+is determined by the configuration file or command line options.
+_EOM_
+);
+
+config_item("dipsw-serial =
yesno", <<<_EOM_
+(LUNA and NEWS Only)
+機種に依存せず DIPSW をシリアルコンソールを使うかどうか指定します。
+"
yes" ならシリアルコンソールを使うように、
+"
no" ならシリアルコンソールを使わないように DIPSW 設定を上書きします。
+"" (空) なら何もしません。デフォルトは "" です。
+
luna-dipsw1 もしくは
news-dipsw (機種による)
+の状態が設定ファイルやコマンドラインオプションによって確定した後に
+このオプションによって該当のスイッチだけを変更します。
+NEWS でシリアルコンソールを使わないを選択した場合、
+SW1,2,3 は OFF, OFF, ON にセットされ、
+NWB-512 モノクロコンソール(未実装) が選択されます。
+
Specifies whether to configure DIPSW to use serial console,
+regardless of the models.
+"yes" overwrites DIPSW, to use serial console.
+"no" overwrites DIPSW, not to use serial console.
+"" (Empty) does nothing.
+The default value is "".
+This option only changes the appropriate switch(es)
+after the luna-dipsw1 or news-dipsw configuration
+is determined by the configuration file or command line options.
+If you choose not to use serial console on NEWS,
+SW1,2,3 will be set OFF, OFF, ON respectively,
+and NWB-512 monochrome console (not implemented) will be chosen.
+_EOM_
+);
+
+config_item(
+ "ethernet-macaddr =
string" .
+ "ethernet
N-macaddr =
string",
+<<<_EOM_
+
N
+番目のイーサネットデバイスの仮想マシン側の MAC アドレスを指定します。
XX:XX:XX:XX:XX:XX
形式で指定します。
auto なら自動的に決定します。
デフォルトは
auto です。
+
ethernet-macaddr は
ethernet0-macaddr の別名です。
+_EOM_
+);
+
+config_item("exec-file =
path", <<<_EOM_
+起動時にロードするホストの実行ファイルを指定します。
+-X オプションとほぼ同等ですが、相対パスは VM ディレクトリを起点にします。
+
Specifiies the host file that will be loaded at startup.
+This is mostly the same as -X option.
+The only one difference is that relative path originates the VM directory.
+_EOM_
+);
+
+config_item("exec-bootparam =
string", <<<_EOM_
+(virt-m68k Only)
+カーネルに渡すブートパラメータを指定します。
+内容はたぶん OS ごとに異なりますが、
+NetBSD/virt68k では "
root=ld0" (クォートを除く)
+のようにしてカーネルにルートデバイスを指示します。
+
Specifies the boot parameter that is passed to the kernel.
+The syntax may differ depending on the OS, but in NetBSD/virt68k,
+you can specify the root device to the kernel, like as
+"root=ld0" (excluding quotes).
+_EOM_
+);
+
+config_item("exec-initrd =
path", <<<_EOM_
+(virt-m68k Only)
+カーネルに渡す初期 RAM ディスクイメージのパスを指定します。
+--initrd オプションとほぼ同等ですが、相対パスは VM ディレクトリを起点にします。
+
Specifies the initial ramdisk image passed to the kernel.
+This is mostly the same as --initrd option.
+The only one difference is that relative path originates the VM directory.
+_EOM_
+);
+
+config_item("extram-size =
integer", <<<_EOM_
+(X68030 Only)
+拡張メモリのサイズを MB 単位で指定します。
+今の所以下だけが指定できます。
+
Specifies the extended RAM size in MB.
+For now, only the following can be specified.
+
+- 0 … 拡張メモリを使用しません。デフォルトです。
+
No extended memory. It's default.
+ - 16 … TS-6BE16 互換モードで、
+アドレス $0100'0000 からの 16MB です。
+
TS-6BE16 compatible mode.
+Its address is from $0100'0000 and the size is 16MB.
+ - 128/256/512 … 060turbo 互換モードで、
+アドレス $1000'0000 からです。
+
060turbo compatible mode. Its address is from $1000'0000.
+
+_EOM_
+);
+
+config_item("fast-mode =
integer", <<<_EOM_
+起動時の動作モードを指定します。0 なら通常モード、1 なら高速モードです。
+デフォルトは 0 です。
+コマンドラインオプション
-f でも高速モードへのみ指定可能です。
+_EOM_
+);
+
+config_item("fd-drive =
integer", <<<_EOM_
+(X68030 Only)
+フロッピードライブの数を 0 から 4 で指定します。
+デフォルトは 2 です。
+
Specifies the number of floppy drives from 0 to 4.
+The default is 2.
+_EOM_
+);
+
+config_item("fd
N-image =
path", <<<_EOM_
+(X68030 Only)
+フロッピードライブ
N に起動時に挿入する
+
ディスクイメージを指定します。
+イメージパスが相対パスなら VM ディレクトリからの相対パスになります。
+起動後はメニューから操作できます。
+デフォルトは空です。
+
Specifies a diskimage to be inserted to floppy drive N at startup.
+If the path is relative path, it is from the VM directory.
+You can also operate them from menu after startup.
+The default is empty.
_EOM_
);
-config_item("hostnet-driver =
string", <<<_EOM_
-イーサネットデバイスのホスト側ドライバを指定します。
-
afpacket、
bpf、
tap のうち
-ホスト OS がサポートしているものと
auto、
none が選択可能です。
-
afpacket は Linux の AF_PACKET ソケットを使用します。
-
bpf は bpf(4) デバイスを使用します。
-
tap は tap(4) インタフェースを使用します。
+config_item("fpu-type =
value", <<<_EOM_
+(X68030 and virt-m68k Only)
+68030 に FPU コプロセッサを装着するかどうか指定しています。
+この設定は
mpu-type が
68030 の時のみ有効です。
+
none なら FPU コプロセッサを装着しません。
+
68881 なら FPU コプロセッサとして 68881 を装着します。
+現状 68882 はサポートしていません。
+また
none の代わりに
0、
+
68881 の代わりに
1 と書くこともできます。
+デフォルトは
68881 です。
+LUNA-I はたぶん 68881 搭載モデルのみのため変更できません。
+
Specifies whether to install FPU co-processor or not.
+This item is meaningful only if mpu-type is 68030.
+If set to none, FPU co-processor is not installed.
+If set to 68881, 68881 FPU co-processor is installed.
+68882 is not supported yet.
+And, none can also be written as 0,
+68881 can also be written as 1.
+The default is 68881.
+This item cannot be specified on LUNA-I
+because (probably) all LUNA-I has 68881.
+_EOM_
+);
+
+config_item(
+ "hostcom-driver =
string" .
+ "hostcom-tcp-port =
integer" .
+ "hostcom-fallback =
integer", <<<_EOM_
+それぞれ
hostcom0-* の別名です。
+
These are aliases for hostcom0-* respectively.
+_EOM_
+);
+
+config_item("hostcom
N-driver =
string", <<<_EOM_
+起動時のシリアルポート
N のホスト側ドライバを指定します。
+
stdio なら標準入出力を使用します。
+
tcp なら TCP ポートで TELNET プロトコルで待ち受けます。
+
console (または
cons)
+ならメイン画面で端末エミュレーションを行います。
none ならホスト側とは一切通信を行いません。
-
auto ならホスト OS がサポートしているもののうち
-
tap →
afpacket →
bpf を順に試します。
+
Specifies the host driver of serial port N on startup.
+stdio uses the standard input/output.
+tcp listens on TCP port using TELNET protocol.
+console (or cons) does a terminal emulation in main panel.
+none doesn't make any communication with the host.
+
+hostcomN と
+VM 内のデバイス(ポート)との対応は下表の通り VM 種別ごとに固定です。
+The correspondence between hostcomN and
+device (port) in the VM is fixed depending on the VM type
+as the following table.
+
+
+| hostcom\VM | LUNA-I/LUNA-88K | X68030 | NWS-1750 | virt-m68k
+ |
|---|
| hostcom0
+ | SIO(uPD7201) Ch.A
+ | SCC(Z8530) Ch.A
+ | SCC(Z8530) Ch.A
+ | Goldfish TTY
+ |
|---|
| hostcom1
+ | HD647180 ASCI Ch.0
+ | N/A
+ | N/A
+ | N/A
+ |
|---|
| hostcom2
+ | HD647180 ASCI Ch.1
+ | N/A
+ | N/A
+ | N/A
+ |
|---|
+
+
+また、VM 種別によって有効なホスト側ドライバの種類とデフォルト値も異なります。
+The choices and default value vary depending on the VM type.
+
+
+| VM | LUNA-I/LUNA-88K | X68030 | NWS-1750 | virt-m68k
+ |
|---|
有効なドライバ
Available drivers
+ | stdio tcp none
+ | stdio tcp none
+ | stdio tcp console none
+ | stdio tcp console none
+ |
|---|
hostcom0-driver のデフォルト値
Default value
+ | none
+ | none
+ | console
+ | console
+ |
|---|
hostcom[12]-driver のデフォルト値
Default value
+ | none
+ | N/A
+ | N/A
+ | N/A
+ |
|---|
+
+
+指定したドライバが使用出来なかった場合エラー終了します。
+起動後はメニューからドライバを変更できますが、パラメータは(まだ?)変更できません。
+実行中に変更に失敗した場合は none にフォールバックします。
+Terminate if the specified driver could not be used.
+You can change the driver by menu at runtime,
+but its parameters cannot be changed (yet?).
+If changing at runtime fails, it will fallback to none.
+_EOM_
+);
+
+config_item("hostcomN-tcp-port = integer", <<<_EOM_
+ホストドライバが tcp の時の TCP 待ち受けポート番号を指定します。
+Specifies the TCP port number that host driver listens.
+_EOM_
+);
+
+config_item("hostcpu-avx2 = string", <<<_EOM_
+ホストが amd64(x86_64) の場合にレンダリングに AVX2
+アクセラレーションを使うかどうかを指定します。
+auto なら起動時にホスト CPU が AVX2 をサポートしているか確認し、
+サポートしていれば使用します。
+no なら AVX2 コードを実行しません。
デフォルトは auto です。
-Specifies the host driver of ethernet device.
-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.
+amd64(x86_64) 以外のホストではこの設定は無視されます。
+Specifies whether to use AVX2 acceleration for rendering
+on amd64(x86_64) host.
+If set to auto, nono checks whether the host CPU supports AVX2
+on startup and use it if it does.
+If set to no, nono will not execute AVX2 instructions.
+The default is auto.
+Note that this item is ignored if the host is not amd64(x86_64).
_EOM_
);
-config_item("hostdriver-afpacket-ifname = ifname", <<<_EOM_
+config_item("hostcpu-neon = string", <<<_EOM_
+ホストが aarch64 の場合にレンダリングに NEON
+アクセラレーションを使うかどうかを指定します。
+auto なら使用し、
+no なら使用しません。
+デフォルトは auto です。
+aarch64 以外のホストではこの設定は無視されます。
+Specifies whether to use NEON acceleration for rendering
+on aarch64 host.
+If set to auto, nono uses NEON code.
+If set to no, nono don't use NEON code.
+The default is auto.
+Note that this item is ignored if the host is not aarch64.
+_EOM_
+);
+
+config_item("hostcpu-fastcore = string", <<<_EOM_
+ホストの CPU がヘテロジニアス構成の場合の高性能コアを列挙します。
+コアの番号は 0,1,2 のようにカンマ区切りで指定します。
+ハイフンで範囲指定も出来ます。
+-2,3,4-7 は 0-7 と等価です。
+どのコアが高性能コアかは dmesg 等で調べてください。
+どのスレッドを割り当てるかはユーザは指定できません。
+コアが一つも指定されないかすべてのコアが指定された場合はホモジニアス構成とみなします。
+auto と書くと自動判別ですが現状 Intel CPU のみ対応しています。
+対称構成の CPU なら指定不要です。
+デフォルトは auto です。
+_EOM_
+);
+
+config_item("hostkbd-input = string", <<<_EOM_
+(LUNA and X68030 Only)
+ホストキーボードの入力モードを指定します。
+char ならキャラクタ入力モード、
+jp なら日本語キーボードモードです。
+デフォルトは char です。
+詳細は VM について の章を参照してください。
+Specifies the input mode of the host keyboard.
+char means the character mode,
+jp means the Japanese keyboard mode.
+The defualt is char.
+See About VM for details.
+_EOM_
+);
+
+config_item(
+ "hostnet-driver = string
" .
+ "hostnet-afpacket-ifname = ifname
" .
+ "hostnet-bpf-ifname = ifname
" .
+ "hostnet-tap-devpath = path
" .
+ "hostnet-usermode-hostfwd = string
" .
+ "hostnet-usermode-net = string
" .
+ "hostnet-usermode-net6 = string
" .
+ "hostnet-fallback = integer
", <<<_EOM_
+それぞれ hostnet0-* の別名です。
+These are aliases for hostnet0-* respectively.
+_EOM_
+);
+
+config_item("hostnetN-driver = string", <<<_EOM_
+起動時の N
+番目のイーサネットデバイスのホスト側ドライバを指定します。
+afpacket、bpf、tap、usermode のうち
+configure で検出したものと auto、none が選択可能です。
+Specifies the host driver of N-th ethernet device on startup.
+afpacket, bpf, tap and usermode can be specified
+only if the configure detects them.
+auto and none can always be specified.
+
+- afpacket は Linux の AF_PACKET ソケットを使用します。
+ホスト自身とは通信できません。
+
afpacket uses Linux's AF_PACKET socket.
+It cannot communicate with the host itself.
+ - bpf は bpf(4) デバイスを使用します。
+ホスト自身とは通信できません。
+
bpf uses bpf(4) device.
+It cannot communicate with the host itself.
+ - tap は tap(4) デバイスを使用します。
+
tap uses tap(4) device.
+ - usermode は libslirp を使用したユーザモードです。
+nono 自身が NAT ルータ、DHCP サーバ、DNS サーバの機能を持ちます。
+
usermode is an usermode network using libslirp.
+nono also acts as NAT router, DHCP server and DNS server.
+ - none ならホスト側とは一切通信を行いません。
+
none doesn't make any communication with the host.
+
+auto は usermode と同義ですが、
+configure で libslirp が無効になっている場合は none と同義になります。
+hostnet0-driver のデフォルトは auto、
+hostnet1-driver のデフォルトは none です。
+auto is a synonym for usermode, but
+when libslirp is disabled on configure, it is a synonym for none.
+The default of hostnet0-driver is auto,
+the default of hostnet1-driver is none.
+
+hostnetN と
+VM 内のデバイスとの対応は下表の通り VM 種別ごとに固定です。
+The correspondence between hostnetN and
+device in the VM is fixed depending on the VM type as the following table.
+
+
+| hostnet\VM | LUNA-I/LUNA-88K | X68030 | NWS-1750 | virt-m68k
+ |
|---|
| hostnet0
+ | Lance(AM7990)
+ | Nereid#0 (RTL8019AS)
+ | Lance(AM7990)
+ | VirtIO Network
+ |
|---|
| hostnet1
+ | N/A
+ | Nereid#1 (RTL8019AS)
+ | N/A
+ | N/A
+ |
|---|
+
+
+指定したドライバが使用出来なかった場合エラー終了します。
+起動後はメニューからドライバを変更できますが、パラメータは(まだ?)変更できません。
+実行中に変更に失敗した場合は none にフォールバックします。
+Terminate if the specified driver could not be used.
+You can change the driver by menu at runtime,
+but its parameters cannot be changed (yet?).
+If changing at runtime fails, it will fallback to none.
+_EOM_
+);
+
+config_item("hostnetN-afpacket-ifname = ifname", <<<_EOM_
ホストドライバが afpacket の時にバインドするインタフェースを1つ指定します。
ifname が auto
なら使用可能なインタフェースを1つ自動的に選択します。
デフォルトは auto です。
なお、このホストドライバではローカルホストとの通信は出来ません。
-Specify an interface name to bind to, when the host driver is afpacket.
+Specifies 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.
@@ -422,13 +998,13 @@ Note that this host driver cannot commun
_EOM_
);
-config_item("hostdriver-bpf-ifname = ifname", <<<_EOM_
+config_item("hostnetN-bpf-ifname = ifname", <<<_EOM_
ホストドライバが bpf の時にバインドするインタフェースを1つ指定します。
ifname が auto
なら使用可能なインタフェースを1つ自動的に選択します。
デフォルトは auto です。
なお、このホストドライバではローカルホストとの通信は出来ません。
-Specify an interface name to bind to, when the host driver is bpf.
+Specifies 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.
@@ -436,7 +1012,7 @@ Note that this host driver cannot commun
_EOM_
);
-config_item("hostdriver-tap-devpath = path", <<<_EOM_
+config_item("hostnetN-tap-devpath = path", <<<_EOM_
ホストドライバが tap の時に使用するデバイスを1つフルパスで指定します。
デフォルトは auto で、この場合は自動的にデバイスを選択します。
この時の探し方はホスト OS によって異なります。
@@ -450,7 +1026,7 @@ NetBSD (と FreeBSD) ならまず /d
nono-ifup, nono-ifdown という名前のシェルスクリプトが必要です。
何もすることがない場合でも正常終了する空のシェルスクリプトを用意してください。
-Specify a device pathname, when the host driver is tap.
+Specifies 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.
@@ -463,25 +1039,144 @@ In all cases, you need to prepare two sh
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.
-
+you need to prepare empty scripts that will terminate successfully.
_EOM_
);
-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.
+config_item("hostnetN-usermode-net = network/netmask", <<<_EOM_
+ホストドライバが usermode の時の、内部 IPv4 ネットワークのアドレスを指定します。
+ネットワークアドレスは
+192.0.2.0/255.255.255.0 のようにネットマスクで指定するか
+192.0.2.0/24 のようにネットマスク長で指定することも出来ます。
+デフォルトは 10.8.0.0/24 です。
+_EOM_
+);
+
+config_item("hostnetN-usermode-net6 = network/prefixlen", <<<_EOM_
+ホストドライバが usermode の時の、内部 IPv6 ネットワークのアドレスを指定します。
+ネットワークアドレスは 2001:db8::/64
+のようにアドレスとプレフィックス長で指定します。
+デフォルトは fd08::/64 です。
+_EOM_
+);
+
+config_item("hostnetN-usermode-hostfwd = entry[;entry[;…]]", <<<_EOM_
+ホストドライバが usermode の時の、外部から内部へのポートフォワーディングの設定を行います。
+1つの entry は
+
+-
+protocol,[hostaddr:]hostport,[guestaddr:]guestport
+
+のように ','(カンマ) 3つで区切って表します。
+protocol は tcp か udp です。
+hostaddr はホストのバインドアドレスで省略すると 0.0.0.0 です。
+guestaddr はゲストのアドレスで、
+省略すると DHCP でクライアントに配布したアドレスになります
+(通常は省略します)。
+例えば、ホストの 10022/tcp へのコネクションをゲストの 22/tcp に転送したい場合は
+tcp,10022,22 となります。
+複数指定する場合は ';'(セミコロン) で区切って1行に並べます。
+
+IPv6 には対応していません。
+_EOM_
+);
+
+config_item("hostsound-driver = string", <<<_EOM_
+サウンドデバイスのホスト側ドライバを指定します。
+alsa、netbsd、sndio のうち configure で検出したものと
+wav、none、auto が選択可能です。
+Specifies the host sound driver.
+alsa, netbsd, and sndio are
+available only if detected by configure.
+wav, none, and auto are always selectable.
+
+- alsa は Linux の ALSA ライブラリを使用します。
+
alsa uses Linux's ALSA library.
+ - netbsd は NetBSD の audio(4) デバイスを使用します。
+
netbsd uses NetBSD's audio(4) device.
+ - sndio は OpenBSD の sndio ライブラリを使用します。
+
sndio uses OpenBSD's sndio library.
+ - wav は VM ディレクトリに WAV ファイルを出力します。
+この WAV ファイルには無音のブロックは出力されません。
+
wav outputs WAV file in the VM directory.
+ This WAV file doesn't contains any silent blocks.
+ - none はホスト側には一切出力しません。
+
none doesn't output anything.
+ - auto なら、configure で検出された一つが選択されます。
+検出されなければ none です。
+
auto selects the one detected by configure.
+ Or act as none if no drivers are detected.
+
+デフォルトは auto です。
+The default is auto.
+_EOM_
+);
+
+config_item("hostsound-alsa-device = string", <<<_EOM_
+ホストドライバが alsa の時のデバイス名を指定します。
+デフォルトは default です。
+_EOM_
+);
+
+config_item("hostsound-netbsd-device = string", <<<_EOM_
+ホストドライバが netbsd の時のデバイスパスを指定します。
+デフォルトは /dev/sound です。
+_EOM_
+);
+
+config_item("iplrom1-image = path", <<<_EOM_
+(X68030 Only)
+X68030 の外部 IPLROM イメージファイルのパスを指定します。
+こちらは 0xfe0000..0xffffff の 128KB の部分で、IPLROM30 と呼ばれているほうです。
+path がファイル名のみなら VM ディレクトリとその親ディレクトリからこのファイル名を検索します。
+path が相対パスなら VM ディレクトリからの相対パスになります (現在のディレクトリからではありません)。
+空にすると無償配布されている IPLROM30 を使用します。
+デフォルトは空です。
+Specifies the X68030's external IPLROM image file path.
+This one contains 128KB at 0xfe0000..0xffffff and is known as IPLROM30.
+If the path does not have any path delimiters,
+the VM directory and then its parent directory will be searched.
+If the path is a relative path,
+it will be path from the VM directory, not from the current directory.
+If the path is empty, the public released IPLROM30 will be used.
+The default value is empty.
+_EOM_
+);
+
+config_item("iplrom2-image = path", <<<_EOM_
+(X68030 Only)
+X68030 の外部 IPLROM イメージファイルのパスを指定します。
+こちらは 0xfc0000..0xfdffff の 128KB の部分で、ROM30 と呼ばれているほうです。
+path がファイル名のみなら VM ディレクトリとその親ディレクトリからこのファイル名を検索します。
+path が相対パスなら VM ディレクトリからの相対パスになります (現在のディレクトリからではありません)。
+空にすると内蔵 ROM を使用します。
+内蔵 ROM は NetBSD/x68k が起動する程度の SCSI IOCS のみサポートしています。
+デフォルトは空です。
+Specifies the X68030's external IPLROM image file path.
+This one contains 128KB at 0xfc0000..0xfdffff and is known as ROM30.
+If the path does not have any path delimiters,
+the VM directory and then its parent directory will be searched.
+If the path is a relative path,
+it will be path from the VM directory, not from the current directory.
+If the path is empty, internal emulated ROM will be used.
+The ROM supports only enough SCSI IOCS to boot NetBSD/x68k.
+The default value is empty.
+_EOM_
+);
+
+config_item("keyboard-connect = integer", <<<_EOM_
+(LUNA and X68030 Only)
+起動時にキーボードを本体に接続するかどうかを指定します。
+1 なら接続し、0 なら接続しません。デフォルトは 1 です。
+起動後はメニューから変更可能です。
+Specifies whether to connect keyboard on boot.
+If 1, it is connected; if 0, it isn't connected. The default is 1.
+You can change it on GUI menu after boot.
_EOM_
);
config_item("luna-adjust-misused-epoch = integer", <<<_EOM_
+(LUNA Only)
LUNA で誤った RTC epoch を採用している OS 向けに RTC
エミュレーションを補正するかどうかを
指定します。0 なら補正をしません(実機と同じ動作)、
@@ -498,14 +1193,12 @@ 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 で同じだと思います)。
+ところが NetBSD/luna68k、OpenBSD/luna88k などはこの
+RTC の年の値を 1970年からの経過年として使用しています。
例えば1970年はうるう年ではないため 2月28日の翌日は 3月1日ですが、
MK48T02 的には 00年であるためうるう年と認識し 2月28日の翌日が2月29日になります。
-このように、実機の RTC は4年のうち約2年間、1日ずれた日付を指しているようです。
+このように、これらの OS を使っている場合実機の
+RTC は4年のうち約2年間、1日ずれた日付を指しているようです。
しかしながら、RTC の時刻は OS 起動時に一度読んだ後は基本的に参照しない上、
今時必要なら NTP で時間を合わせるため、
実機でも問題が顕在化することはまずないと思います。
@@ -519,10 +1212,11 @@ _EOM_
);
config_item("luna-dipsw1 = string", <<<_EOM_
+(LUNA Only)
本体前面 DIPSW#1-1..#1-8 の内容を指定します。
"0" を DOWN、"1" を UP として、
これを8つ並べた形式で、前から順に #1..#8 に対応します。
-Specifies status of the front panel DIPSW#1-1..#1-8 using 8 digit.
+Specifies status of the front panel DIPSW#1-1..#1-8 using 8 digits.
"0" means DOWN and "1" means UP.
The first character corresponds to #1 and
the eighth character corresponds to #8.
@@ -534,16 +1228,26 @@ See the following link about DIPSW.
<
→ NetBSD/luna68k: Information
-LUNA88K でのデフォルトは 11111111 です。
+LUNA-88K でのデフォルトは 11111111 です。
各スイッチの内容は以下のリンクを参照してください。
-On LUNA88K, the default value is 11111111.
+On LUNA-88K, the default value is 11111111.
See the following link about DIPSW.
→ OpenBSD manual pages: boot_luna88k(8)
+
+自動起動するかどうかとシリアルコンソールを使うかどうかを指定したい場合は
+こちらではなく
+dipsw-autoboot、dipsw-serial
+設定を使うほうが便利です。
+If you only want to specify whether to autoboot and/or
+to use serial console,
+dipsw-autoboot, dipsw-serial
+configurations are useful.
_EOM_
);
config_item("luna-dipsw2 = string", <<<_EOM_
+(LUNA Only)
本体前面 DIPSW#2-1..#2-8 の内容を指定します。
書式は luna-dipsw1 と同じです。
デフォルトは 11111111 です。
@@ -559,35 +1263,114 @@ DIPSW#2 が "11111111" なら
if the DIPSW#2 is "11111111".
Otherwise, the bootloader will enter interactive mode.
(I doubt that they actually wanted to switch with only #8)
-
-
+
+_EOM_
+);
+
+config_item("luna-video-plane = integer", <<<_EOM_
+(LUNA Only)
+LUNA のビデオボードのプレーン数を 1、4、8 から指定します。
+1 ならモノクロビデオボード、
+4 なら16色 (4bpp) ビデオボード、
+8 なら 256色 (8bpp) ビデオボードです。
+デフォルトは 4 です。
+Specifies number of planes on LUNA video board.
+The valid values are 1, 4 or 8.
+1 means a monochrome video board,
+4 means 16-color (4bpp) video board,
+8 means 256-color (8bpp) video board.
+The default value is 4.
+_EOM_
+);
+
+config_item(
+ "m88100-version = integer
" .
+ "m88200-version = integer", <<<_EOM_
+(LUNA-88K Only)
+MPU と CMMU のマスクバージョンを設定します。
+今の所これによるエミュレータの動作の違いはありません。
+どちらかというとこれを参照しているゲスト OS の動作確認用です。
+デフォルトは m88100-version が 11、m88200-version が 9 です。
+Specifies MPU and CMMU mask version.
+This item doesn't affect any MPU/CMMU emulations for now.
+But it may be useful for verifying the guest OS behaviors.
+The default value is 11 for m88100-version,
+9 for m88200-version.
+_EOM_
+);
+
+config_item("mainview-scale = double", <<<_EOM_
+メインウィンドウの起動時のスケールを実数で指定します。
+コマンドラインオプション -s で上書き可能です。
+起動後はメニューから、
+プリセットされた倍率とここで指定した倍率には変更可能です。
+デフォルトは 1.0 です。
+_EOM_
+);
+
+config_item("monitor-fontsize = integer",
+<<<_EOM_
+テキスト系モニタとステータスパネルのフォントサイズを
+12, 16, 24 から指定します。
+コマンドラインオプション --fontsize で上書き可能です。
+起動後はメニューから変更することができます。
+デフォルトは 12 です。
_EOM_
);
config_item("monitor-rate = integer", <<<_EOM_
テキスト系モニタウィンドウの更新頻度を Hz 単位で指定します。
1 から 60 までの間で指定でき、デフォルトは 20Hz です。
-起動後にメニューからプリセットされた頻度には変更可能です。
+起動後にメニューから、
+プリセットされた頻度とここで指定した頻度には変更可能です。
Specifies refresh rate of all text monitor windows in Hz.
It ranges from 1 to 60. The default is 20Hz.
-You can change this value on GUI menu after boot,
-but unlike this configuration value, there are only a few preset choices.
-
+You can choose this value on GUI menu after boot,
+from preset rate or rate specified here.
_EOM_
);
config_item("mpu-clock = value", <<<_EOM_
MPU のクロック数を MHz 単位で指定します。
-デフォルトは LUNA-I なら 20MHz、LUNA88K なら 25MHz です。
+デフォルトは LUNA-I なら 20MHz、LUNA-88K と X68030 なら 25MHz です。
+virt-m68k ではあまり意味はありませんが 25MHz です。
Specifies the MPU clock in MHz.
-The default value is 20MHz on LUNA-I, or 25MHz on LUNA88K.
+The default value is 20MHz on LUNA-I, or 25MHz on LUNA-88K and X68030.
+On virt-m68k, it's less meaningful but 25MHz.
_EOM_
);
-/* luna には不要
- config_item("mpu-has-fpu", ""); */
+config_item("mpu-force-disable-dcahce = integer
" .
+ "mpu-force-disable-icache = integer", <<<_EOM_
+
+MPU のデータキャッシュ(dcache)/命令キャッシュ(icache)
+を強制的に無効にすることが出来ます。
+0 ならキャッシュを常に無効にします。1 なら通常動作です。
+デフォルトは 1 です。
+MPU が 68030 の場合 CACR の EI, ED に 1 を書き込んでも 0 のままになるという意味です。
+m88k は未対応です。
+You can forcibly disable MPU data cache (dcache)/instruction cache (icache).
+0 means forcibly disable the cache.
+1 means normal operation.
+The default is 1.
+On 68030, forcibly disable means that even if
+you write 1 to EI, ED on CACR, it will remain 0.
+Not supported for m88k.
+
+_EOM_
+);
+
+config_item("mpu-type = value", <<<_EOM_
+(X68030, virt-m68k Only)
+MPU 種別を 68030 か 68040 で指定します。
+デフォルトは 68030 です。
+Specifies the MPU type, 68030 or 68040.
+The default is 68030.
+_EOM_
+);
config_item("mpu-pseudo-stop = integer", <<<_EOM_
+(LUNA-88K Only)
m88100 にて疑似 STOP 状態を有効にするかどうかを指定します。
0 なら無効(実機と同じ動作)、1 なら有効で、デフォルトは 1 です。
m88100 には、m68k の STOP 命令 (割り込みが上がるまで何もせず待つ)
@@ -602,18 +1385,107 @@ m88100 には、m68k の STOP 命令 (
_EOM_
);
+config_item(
+ "nereid0-enable = integer
" .
+ "nereid1-enable = integer
", <<<_EOM_
+(X68030 Only)
+Nereid 拡張ボードを装着するかどうかを指定します。
+Nereid は同時に2枚まで使用することができます。
+値は 0 なら装着せず、1 なら装着します。
+デフォルトは 0 (装着しない) です。
+詳細は Nereid エミュレーション の項を参照してください。
+Specifies whether install Nereid expansion board or not.
+Up to two board can be operated at the same time.
+If set to 0, the board is not installed.
+If set to 1, the board is installed.
+The default value is 0.
+See also Nereid emulation section below for details.
+_EOM_
+);
+
+config_item(
+ "nereid0-net = integer
" .
+ "nereid1-net = integer
", <<<_EOM_
+(X68030 Only)
+Nereid ボードの NIC (RTL8019AS) のみを無効にすることが出来ます
+(実機では通常そのようなことは出来ません)。
+0 なら無効、1 なら有効です。デフォルトは 1 です。
+通常は 1 のまま使用してください。
+この設定は対応する nereidN-enable が 0
+(ボードを装着しない) の場合は意味を持ちません。
+This can disable only NIC (RTL8019AS) of Nereid expansion board
+(although it's not possible normally in the real world).
+It's disabled if 0, or enabled if 1.
+The default is 1. Normally, leave it 1.
+This item will be ignored if the corresponding nereidN-enable
+is 0.
+_EOM_
+);
+
+config_item(
+ "nereid0-ram-size = integer
" .
+ "nereid1-ram-size = integer
", <<<_EOM_
+(X68030 Only)
+Nereid ボードのバンクメモリのサイズを MB 単位で指定します。
+指定できるのは 0, 4, 16 です。
+0 を指定するとバンクメモリを無効にします。
+デフォルトは 16 です。
+この設定は対応する nereidN-enable が 0
+(ボードを装着しない) の場合は意味を持ちません。
+Specifies bank memory size in MB of Nereid expansion board.
+The valid values are 0, 4 or 16.
+If set to 0, disable the bank memory.
+The default is 16.
+This item will be ignored if the corresponding nereidN-enable
+is 0.
+
+また通常は必要ありませんが -4 または -16 を指定すると、
+バンクメモリは無効にした上で Nereid 制御ポートのビット6の読み出し値
+(バンクメモリの容量) を再現することが出来ます。
+-4 ならビット6は 0 (4MB)、0 か -16 なら 1(16MB) が読み出せます。
+_EOM_
+);
+
+config_item("news-dipsw = string", <<<_EOM_
+(NEWS Only)
+DIPSW の内容を指定します。
+"0" を OFF、"1" を ON として、
+これを8つ並べた形式で、前から順に SW1..SW8 に対応します。
+デフォルトは 00001000 です。
+Specifies status of the DIPSW using 8 digits.
+"0" means OFF and "1" is ON.
+The first character corresponds to SW1 and
+the eighth character corresponds to SW8.
+The default valus is 00001000.
+
+各スイッチの内容は以下のリンクを参照してください。
+See the following link about DIPSW.
+→ NetBSD/news68k Frequently Asked Questions
+
+自動起動するかどうかとシリアルコンソールを使うかどうかを指定したい場合は
+こちらではなく
+dipsw-autoboot、dipsw-serial
+設定を使うほうが便利です。
+If you only want to specify whether to autoboot and/or
+to use serial console,
+dipsw-autoboot, dipsw-serial
+configurations are useful.
+_EOM_
+);
+
config_item("prom-image = path", <<<_EOM_
-LUNA-I/LUNA88K の外部 ROM イメージファイルのパスを指定します。
+(LUNA Only)
+LUNA-I/LUNA-88K の外部 ROM イメージファイルのパスを指定します。
path がファイル名のみなら VM ディレクトリとその親ディレクトリからこのファイル名を検索します。
path が相対パスなら VM ディレクトリからの相対パスになります (現在のディレクトリからではありません)。
空にすると内蔵 ROM を使用します。
デフォルトは空です。
-Specifies the LUNA-I/LUNA88K's external ROM image file path.
+Specifies the LUNA-I/LUNA-88K's external ROM image file path.
If the path does not have any path delimiters,
the VM directory and then its parent directory will be searched.
If the path is a relative path,
-it will be path from the VM directory, not from the current
-directory.
+it will be path from the VM directory, not from the current directory.
If the path is empty, internal emulated ROM will be used.
The default value is empty.
@@ -621,8 +1493,7 @@ The default value is empty.
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).
-
+if you set this field empty (or leave it as the default).
LUNA-I 実機を持っている場合は
ROM ファイルを指定することで実機 ROM で起動できます。
@@ -634,64 +1505,102 @@ you can boot with the real ROM spcifying
The ROM file is extracted from 0x41000000-0x4101ffff (128KB) of
the real LUNA-I machine.
For now, only V4.22 (Thu Jul 27 11:45:42 1989) is supported.
-I have no idea about other ROMs.
-
+I have no idea about other ROMs.
-LUNA88K 実機の場合は 0x41000000-0x4103ffff (256KB) を保存したものです。
+LUNA-88K 実機の場合は 0x41000000-0x4103ffff (256KB) を保存したものです。
今のところ ROM は version 1.20 のみサポートしています。
-For LUNA88K,
+For LUNA-88K,
the ROM file is extracted from 0x41000000-0x4103ffff (256KB).
-For now, only version 1.20 is supported.
-
+For now, only version 1.20 is supported.
_EOM_
);
config_item("ram-size = integer", <<<_EOM_
-搭載する RAM サイズを MB 単位で指定します。
-LUNA-I のデフォルトは 16MB です。
+搭載する RAM サイズを MB 単位で指定します。Specifies the RAM size in MB.
+
+- LUNA-I のデフォルトは 16MB です。
16MB 未満は 4MB 単位で、
-16MB 以上は 255MB まで 1MB 単位で指定できます
-(ちなみに NetBSD/luna68k の起動には最低でも 8MB 必要です)。
-LUNA88K のデフォルトは 64MB です。
-64MB 未満は 16MB 単位で、
-64MB 以上は暫定で 255MB まで 1MB 単位で指定できます。
-
Specifies the RAM size in MB.
-On LUNA-I, the default is 16MB.
+16MB 以上は 512MB まで 1MB 単位で指定できます。
+ただし prom-image で実機イメージを指定した場合は 255MB が上限になります。
+ちなみに NetBSD/luna68k の起動には最低でも 8MB 必要です。
+On LUNA-I, the default is 16MB.
If the size is less than 16MB, you can specify in 4MB unit.
-If larger, you can specify up to 255MB in 1MB unit.
-By the way, NetBSD/luna68k needs at least 8MB to boot.
-On LUNA88K, the default is 64MB.
+If larger, you can specify up to 512MB in 1MB unit.
+However, if you have prom-image with the real image,
+the maximum is limited to 255MB.
+By the way, NetBSD/luna68k needs at least 8MB to boot.
+- LUNA-88K のデフォルトは 64MB です。
+64MB 未満は 16MB 単位で、
+64MB 以上は暫定で 512MB まで 1MB 単位で指定できます。
+ただし prom-image で実機イメージを指定した場合は
+240MB が上限になります。
+
On LUNA-88K, the default is 64MB.
If the size is less than 64MB, you can specify in 16MB unit.
-If larger, you can specify up to tentative 255MB in 1MB unit.
-
+If larger, you can specify up to tentative 512MB in 1MB unit.
+However, if you have prom-image with the real image,
+the maximum is limited to 240MB.
+ - X68030 ではメイン RAM 容量を示し、デフォルトは 12MB です。
+4MB から 12MB まで 1MB 単位で指定できます。
+拡張メモリについては extram-size を参照してください。
+
On X68030, the default is 12MB.
+You can specify it in 1MB unit from 4MB to 12MB.
+See extram-size for extended memory.
+ - NWS-1750 では現状 16MB で変更できません。
+
On NWS-1750, This is 16MB fixed for now.
+ - virt-m68k のデフォルトは 128MB です。
+16MB から 4080MB まで指定可能です。
+指定された値が 16MB で割り切れない場合は 16MB 単位に切り上げになります。
+
On virt-m68k, the default is 128MB and
+the range is 16MB to 4080MB.
+If the specified size is not divisible by 16MB,
+it will be rounded up to 16MB.
+
+_EOM_
+);
+
+config_item("rtc-epoch-year =
integer", <<<_EOM_
+(LUNA Only)
+RTC (MK48T02) の基準年を指定します。
+デフォルトは 1970年です。
+NetBSD/luna68k、OpenBSD/luna88k はいずれも基準年を 1970年としていますので、
+デフォルトのままで構いません。
+ゲスト OS に 4.4BSD を使用する際は 1900 を指定します。
+NEWS では今の所 1900 固定で変更出来ません。
+
Specifies the RTC (MK48T02) epoch year.
+The default is 1970.
+Since both NetBSD/luna68k and OpenBSD/luna88k use 1970 as epoch year,
+there is no need to touch this value.
+If you boot 4.4BSD on LUNA-I as the guest OS, specify 1900.
+On NEWS, it is fixed at 1900.
_EOM_
);
config_item("show-statuspanel =
integer", <<<_EOM_
ステータスパネルを表示するかどうかを指定します。
0 なら非表示、1 なら表示です。
+デフォルトは 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.
-
+The default is 1 (show).
+You can change it on GUI menu after boot.
_EOM_
);
config_item("spc0-id
N-image =
devtype[,
path]", <<<_EOM_
-SCSI デバイスとイメージを指定します。キーの
N には 0 から 7 が入ります。
+(LUNA and X68030 Only)
+SCSI デバイス種別と
ディスクイメージを指定します。
+キーの
N には 0 から 7 が入ります。
ただし ID 7 は本体が使用しますので指定しないでください。
値はデバイス種別
devtype とディスクイメージパス
path
を "
,"(カンマ) で区切って並べた形式です。
デバイス種別
devtype は以下のいずれかです。
-
-Specifies SCSI device and image. N in the key 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 disk image path path separated by ","(comma).
-devtype can be one of the following:
-
+devtype can be one of the following:
- hd … HD drive
- cd … CD-ROM drive
@@ -702,26 +1611,24 @@ the disk image path path separate
devtype が hd なら path は省略できません。
devtype が cd か mo なら path は省略可能です。
イメージパスが相対パスなら VM ディレクトリからの相対パスになります。
-
-If devtype is hd, path cannot be ommitted.
+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.
-
+If the path is relative path, it is from the VM directory.
-例えば、nono.cfg と同じディレクトリに置いた sd0.img を
+例えば、nono.cfg と同じディレクトリに置いた sd0.qcow2 を
起動 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
+For example, if you use a harddisk image sd0.qcow2 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,sd0.img
+spc0-id6-image = hd,sd0.qcow2
spc0-id5-image = cd,install.iso
spc0-id4-image = mo
@@ -729,6 +1636,7 @@ _EOM_
);
config_item("spc0-idN-seektime = integer", <<<_EOM_
+(LUNA and X68030 Only)
指定の SCSI HDD の平均シークタイムを msec 単位で指定します。
現在のデフォルトは 0 です (S・S・D!! S・S・D!!)。
16 程度を指定すると幾分往時に思いを馳せることが出来るかもしれませんが、
@@ -737,30 +1645,32 @@ config_item("spc0-idN-seektime =
Currently, the default value is 0
(This may be something like SSD :-).
If you specify about 16 or so, you can feel nostalgic,
-but this feature is still unstable.
-
+but this feature is still unstable.
_EOM_
);
config_item("spc0-idN-writeignore = integer", <<<_EOM_
-指定の SCSI HD デバイスへの書き込みを無視するかどうか指定します。
+(LUNA and X68030 Only)
+指定の SCSI HD デバイスへの書き込みをイメージに書き戻すかどうか指定します。
0 なら通常動作(書き込みを行う)です。
-1 なら書き込みコマンドは成功したように振る舞いますが実際には
-ディスクイメージに一切書き戻しません。
+1 ならディスクイメージに一切書き戻しません。
+デバイスへ書き込んだはずのデータは Copy-On-Write の要領で、
+VM ディレクトリ内の一時ファイルに書き込みます。
+この一時ファイルはアプリケーション終了時に削除します。
fsck を気にせずカーネルのデバッグとかを行いたい場合にはどうぞ。
何が起きるか意味が分からない人は指定しないでください。
デフォルトは 0 です。
-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
-even though the write command is succeeded.
-nono's SCSI devices acts as
-write command is successfully done but it never writes back
-to the actual disk image.
+Specifies whether nono writes a writing to SCSI HD devices back
+to the diskimage.
+0 means normal operation (writes to the diskimage).
+1 means that nono will not write to the diskimage back.
+Data that the guest wrote to the device will be written to a temporary file
+in the VM directory,
+like Copy-On-Write.
+The temporary file will be removed when the application exits.
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.
+after the kernel hangs or reboots.
+Don't use this flag if you don't understand this paragraph.
The default value is 0.
ちなみに、メディアを書き込み禁止にしたい場合はこれではなく、
@@ -771,32 +1681,594 @@ clear the write permission from the imag
_EOM_
);
-config_item("spc0-idN-writeprotect = integer", <<<_EOM_
-古いオプションです。
-代わりに spc0-idN-writeignore を使ってください。
-このオプションは開発用です。
-Obsolete.
-Use spc0-idN-writeignore instead.
-This option is for developers.
-
+config_item("sram-sync-ramsize = integer", <<<_EOM_
+(X68030 Only)
+SRAM の RAM 容量欄を実際の RAM サイズに合わせるかどうかを指定します。
+0 なら何もしません (実機と同じ)。
+1 なら、アプリケーション起動時に
+SRAM の \$ed0008.L (RAM 容量) を ram-size の設定値で更新します。
+この更新は、
+アプリケーション起動時に SRAM マジックが正しく書かれている場合のみ行われます。
+デフォルトは 1 です。
+Specifies whether to synchronize a RAM size field in SRAM
+with real RAM size or not.
+If set to 0, the application will do nothing (as same as the real).
+If set to 1, the application updates(synchronizes)
+\$ed0008.L (RAM size) in SRAM with configuration value of ram-size.
+This update is performed once only if
+the SRAM magic string is correct at the application startup.
+The default is 1.
+_EOM_
+);
+
+config_item("virtio-blockN-image = path", <<<_EOM_
+(virt-m68k Only)
+VirtIO ブロックデバイスのディスクイメージを指定します。
+キーの N は現状 0 から 7 が指定可能です。
+イメージパスが相対パスなら VM ディレクトリからの相対パスになります。
+Specifies VirtIO block device's image.
+N in the key is 0 through 7 for now.
+If the path is relative path, it is from the VM directory.
+_EOM_
+);
+
+config_item("virtio-blockN-writeignore = integer", <<<_EOM_
+(virt-m68k Only)
+指定の VirtIO ブロックデバイスへの書き込みをイメージに書き戻すかどうか指定します。
+詳細は spc0-idN-writeignore を参照してください。
+Specifies whether nono writes a writing to VirtIO block devices back
+to the diskimage.
+See spc0-idN-writeignore for details.
+_EOM_
+);
+
+config_item("virtio-entropy = integer", <<<_EOM_
+
+VirtIO エントロピーデバイスを無効にすることが出来ます。
+0 なら無効、1 なら有効です。デフォルトは 1 です。
+You can disable VirtIO entropy device.
+0 means disabled, 1 means enabled.
+The default is 1.
+
_EOM_
);
+
+config_item("virtio-net = integer", <<<_EOM_
+
+VirtIO ネットワークデバイスを無効にすることが出来ます。
+0 なら無効、1 なら有効です。デフォルトは 1 です。
+You can disable VirtIO network device.
+0 means disabled, 1 means enabled.
+The default is 1.
+
+_EOM_
+);
+
+config_item("virtio-scsi = integer", <<<_EOM_
+
+VirtIO SCSI デバイスを無効にすることが出来ます。
+0 なら無効、1 なら有効です。デフォルトは 1 です。
+You can disable VirtIO SCSI device.
+0 means disabled, 1 means enabled.
+The default is 1.
+
+_EOM_
+);
+
+config_item("virtio-scsi-idN-image = devtype[,path]", <<<_EOM_
+(virt-m68k Only)
+VirtIO SCSI デバイス種別とディスクイメージを指定します。
+イニシエータ ID が不要なため、
+キーの N には 0 から 7 が指定できます。
+詳細は spc0-idN-image を参照してください。
+Specifies VirtIO SCSI device and image.
+You can specify all of 0 thorugh 7 for the key N,
+because there is no initiator.
+See spc0-idN-image for more details.
+_EOM_
+);
+
+config_item("virtio-scsi-idN-writeignore = integer", <<<_EOM_
+(virt-m68k Only)
+指定の VirtIO SCSI デバイスへの書き込みをイメージに書き戻すかどうか指定します。
+詳細は spc0-idN-writeignore を参照してください。
+Specifies whether nono writes a writing to VirtIO SCSI devices back
+to the diskimage.
+See spc0-idN-writeignore for details.
+_EOM_
+);
+
+config_item("windrv-path = path", <<<_EOM_
+(X68030 Only)
+Windrv でゲスト側に見せるホストディレクトリを指定します。
+今の所指定できるディレクトリは1つだけです。
+空なら Windrv デバイスが存在しないように振る舞います。
+デフォルトは空です。
+_EOM_
+);
+
+config_item("x68k-cut-fc2 = integer", <<<_EOM_
+(X68030 Only)
+MPU (68030) の FC2 ピンを切断するかどうかを指定します。
+0 なら切断しません (標準の状態)。
+1 なら切断します。
+デフォルトは 1 です。
+NetBSD/x68k で X サーバを起動する場合のみ 1 にする必要があります。
+Specifies whether to cut MPU(68030) FC2 pin.
+If set to 0, no modification is applied
+(the original FC2 pin is kept).
+If set to 1, the FC2 pin is cut.
+The default is 1.
+Only if you run the X server on NetBSD/x68k, it needs to be 1.
+_EOM_
+);
+
+config_item("xp-clock = value", <<<_EOM_
+(LUNA Only)
+XP プロセッサのクロック数を MHz 単位で指定します。
+デフォルトは 6.144 [MHz] です。
+Specifies the XP processor's clock in MHz.
+The default value is 6.144 MHz.
+_EOM_
+);
+
+
?>
+
+
+
+About VM"); ?>
+
+Implementation Status"); ?>
+
+MMU、キャッシュあたりはほぼ実装していると思います。
+命令の実行サイクルについてはある程度似せているつもりですが、
+68000 のようにサイクル数を正確に数えるのは困難です。
+
+
+
+
+
+いくつか未実装の命令があります。
+キャッシュは未実装で、
+それに伴いキャッシュ制御を行う新設命令 CINV*, CPUSH* も未実装です。
+MMU、ATC はまだ怪しいです。
+FPU はある程度動作すると思いますが
+例外を起こす細かい条件は未検証のため、
+本来は例外が起きてソフトウェア (FPSP) で処理するはずのものが
+68881 相当のハードウェアエミュレーションで実行出来てしまうという
+通常あまり困らないタイプの問題は存分にあります。
+
+命令の実行サイクルについてはある程度似せているつもりですが、
+そもそも 68040 はパイプライン方式なので 68000 時代のようにサイクル数を
+正確にエミュレーションすることはおそらく不可能です。
+
+68040 は X68030 と virt-m68k でのみ選択可能です。
+NEWS に 68040 搭載モデルはなさそうなのと、
+LUNA では 68040 搭載モデルは LUNA-I ではなく LUNA-II になるからです。
+
+
+
+
+
+X68030 のグラフィック画面を一部実装しています。
+これにより NetBSD/x68k の標準設定の X サーバは起動します。
+グラフィック画面として実装しているのは 1024x1024 (16色) モードのみです。
+ビデオコントローラは、画面間プライオリティと画面オンオフを実装しており、
+テキスト画面とグラフィック画面の優先度を変更することは出来ます。
+ただし合成や半透明合成は未実装ですので実質切り替えられるだけです。
+スクロール等 CRTC の機能も未実装です。
+
+
+
+
+
+virt-m68k (や NEWS) のようにシリアルコンソールしか持たない機種のために、
+メイン画面でシリアルコンソールの端末エミュレーションを実装してあります。
+hostcom-driver = console とすることで nono のメイン画面に
+シリアルコンソールの内容が表示されます。
+
+概ね VT220 互換です。
+ただし倍角文字、背景色切り替え、タブ設定等サポートしてないものもあります。
+VT220 互換のためカラーはサポートしていません。
+132 桁モードをサポートしました。
+ブリンクをサポートしました。
+VT220 にはないイタリックはサポートしています。
+
+バックログはありませんので、バックログが必要なら
+stdio 等を使ってください。
+
+
+ディスクイメージ
+usermode ネットワークでは nono 自身が
+NAT ルータ、DHCP サーバ、DNS サーバの機能を持ちます。
+ルータと DHCP サーバのアドレスはネットワークアドレス +1 (デフォルトでは 10.8.0.1)、
+DNS サーバのアドレスはネットワークアドレス +2 (デフォルトでは 10.8.0.2) です。
+IPv6 ルータのアドレスはネットワークアドレス +1 (デフォルトでは fd08::1)、
+DNS サーバのアドレスはネットワークアドレス +2 (デフォルトでは fd08::2) です。
+
+
+
+Nereid emulation on X68030"); ?>
+
+DIPSW 設定ウィンドウでの変更はアプリケーション起動中のみ有効です。
+またここでの設定は即 VM に反映されますが、
+LUNA の場合 DIPSW の状態を
+PIO(8255) がラッチするのが概ね起動時および再起動時のみとなっています
+(厳密には PROM と XP が云々ですが)。
+
+
+
+Memory Dump Monitor"); ?>
+
+m68k/m88k バスに接続されているデバイスを表示します。
+32ビットアドレスのうち上位 8 ビット、256個分を表示しています。
+1枠が 16MB になります。
+また、X68030 ではこのうち 24ビット空間を別モニタで表示します。
+こちらは 1枠 8KB x 2048個です。
+どちらも内部構造を表示しているだけなので名前に馴染みがない場合があるかもしれません。
+NEWS のデバイスマップは内部構造の都合上、
+内部状態を正確に反映していないケースがあるかも知れません。
+
+
+
+Key input mode"); ?>
+
LUNA では、キーボードがハードウェア側でキーリピートを行わず、
ソフトウェア(OS など)がキーリピートの処理を行います。
@@ -848,8 +2755,7 @@ VM が高速動作するとキーリピ
(ALT + TAB やアクセラレータキーでメニューを開くと起きがちです)
高速モードが抑制されたままということが起きえます。
その場合はソフトウェアキーボードからキー入力を解除するなどしてください。
-
-On LUNA,
+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
@@ -860,26 +2766,24 @@ if the VM is running faster than the rea
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.
+while any keys are pressed on LUNA.
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.
-
+In this case, you can resolve it by using the software keyboard window.
+
+
-