Annotation of nono/doc/index.php, revision 1.1.1.24

1.1.1.2   root        1: <!--
                      2:  nono
                      3:  Copyright (C) 2020 nono project
                      4:  Licensed under nono-license.txt
                      5: -->
                      6: <?php require_once "common.php"; ?>
1.1.1.17  root        7: <html>
                      8: <head>
                      9: <?php
                     10:        get_version();
                     11:        print_head_common();
                     12: ?>
                     13: <title>nono document (<?php print $nono_ver; ?>)</title>
                     14: </head>
1.1.1.14  root       15: <?php
                     16: function H4($name, $title)
                     17: {
                     18:        global $h4number;
                     19:        global $h5number;
                     20:        $h4number++;
                     21:        $h5number = 0;
                     22:        print <<<_EOM_
                     23: <a name="{$name}"></a>
                     24: <details open style="padding-top: 1em">
                     25: <summary><span class=h4>{$h4number}. {$title}</span></summary>
                     26: _EOM_;
                     27: }
                     28: function H4end()
                     29: {
                     30:        print "</details>\n";
                     31: }
                     32: 
                     33: function H5($name, $title)
                     34: {
                     35:        global $h4number;
                     36:        global $h5number;
                     37:        $h5number++;
                     38:        print <<<_EOM_
                     39: <a name="{$name}"></a>
                     40: <details open style="padding-top: 1em">
                     41: <summary><span class=h5>{$h4number}.{$h5number}. {$title}</span></summary>
                     42: _EOM_;
                     43: }
                     44: function H5end()
                     45: {
                     46:        print "</details>\n";
                     47: }
                     48: ?>
1.1       root       49: <body>
1.1.1.11  root       50: <h3>nono <?=$nono_ver?> (<?=$nono_date?>)</h3>
1.1       root       51: 
1.1.1.16  root       52: nono は NetBSD とかで動作する OMRON LUNA-I/LUNA-88K のエミュレータです。
1.1.1.17  root       53: 何故か SHARP X68030 と virt-m68k も動いたりするかも知れません。
1.1.1.16  root       54: <q>nono is OMRON LUNA-I/LUNA-88K emulator runs on NetBSD and etc.
1.1.1.17  root       55: It can also emulate SHARP X68030 and virt-m68k.</q>
1.1.1.8   root       56: 
                     57: <hr>
                     58: 
                     59: <h4>Index of this page:</h4>
1.1.1.7   root       60: <div class="main">
1.1.1.10  root       61: <a href="#build">1. ビルド方法 <q>How to build</q></a><br>
1.1.1.13  root       62: <a href="#execute">2. 実行方法 <q>How to execute</q></a><br>
1.1.1.10  root       63: <a href="#configuration">3. 設定 <q>Configuration</q></a><br>
                     64: <a href="#aboutvm">4. VM について <q>About VM</q></a><br>
                     65: <a href="#tryit">5. 実行してみる <q>Try it</q></a><br>
1.1.1.13  root       66: <a href="#network">6. ホストネットワーク設定例 <q>Example of host network setup</q></a><br>
1.1.1.12  root       67: <a href="#knownissues">7. 既知の問題 <q>Known Issues</q></a><br>
                     68: <a href="#migrate">8. 過去のバージョンからの移行方法
1.1.1.9   root       69: <q>How to migrate from old versions</q></a><br>
1.1.1.12  root       70: <a href="#changes">9. 変更履歴 <q>Changes</q></a><br>
                     71: <a href="#license">10. 連絡先、ライセンス等 <q>Contact, License, etc</q></a><br>
                     72: </div>
                     73: <p>
                     74: <div class="main">
                     75: <span class="new">緑背景</span>は新規または目立った更新のあった箇所です。
                     76: <q><span class="new">Green Background</span> is new or updated paragraph.</q>
                     77: </div>
                     78: 
                     79: 
1.1.1.14  root       80: <?php H4("build", "ビルド方法 <q>How to build</q>"); ?>
1.1       root       81: <div class="main">
1.1.1.5   root       82: ビルドには以下が必要です。
1.1.1.13  root       83: <q>The followings are required for build.</q>
1.1.1.5   root       84: 
1.1       root       85: <ul>
1.1.1.2   root       86: <li>make (BSD make, not GNU make)
1.1.1.4   root       87: <li>C/C++ compiler which supports -std=c++14.
                     88: <br>
1.1.1.17  root       89: (For gcc, at least 7.4 or later.
                     90: For clang, at least 7.0 or later.)
                     91: <li>wxWidgets 3.2.x "stable" branch.
1.1.1.19  root       92:  (3.0.x "old stable" branch would also work.)
1.1.1.2   root       93: <li>gettext
1.1.1.24! root       94: <li>libslirp (4.7.0 or later is comfirmed, 4.8.0 is preferred.)
1.1       root       95: </ul>
1.1.1.2   root       96: 
1.1.1.5   root       97: <p>
1.1.1.19  root       98: NetBSD(pkgsrc) なら必要なパッケージは
1.1.1.20  root       99: x11/wxGTK32 と net/libslirp です。
1.1.1.19  root      100: wxGTK32 の代わりに wxGTK30 でも動くはずです。
1.1.1.13  root      101: <q>If you use NetBSD(pkgsrc),
1.1.1.20  root      102: x11/wxGTK32 and net/libslirp are needed.
                    103: wxGTK30 would also work.</q>
1.1.1.13  root      104: 
                    105: <p>
1.1.1.5   root      106: (NetBSD 以外でのビルドはサポートしていませんが)
1.1.1.19  root      107: Ubuntu 24.04 ではたぶん以下のパッケージが必要です。
                    108: <q>You may need the following packages on Ubuntu 24.04
1.1.1.5   root      109: (though we won't support non-NetBSD platform).</q>
                    110: </p>
1.1.1.19  root      111: <dl>
                    112: <dd>
1.1.1.17  root      113: bmake,
                    114: build-essential,
                    115: gettext,
1.1.1.24! root      116: libasound2-dev,
1.1.1.17  root      117: libbsd-dev,
                    118: libkqueue-dev,
1.1.1.20  root      119: libslirp-dev,
1.1.1.17  root      120: libwxgtk3.2-dev,
1.1.1.5   root      121: zlib1g-dev
1.1.1.19  root      122: </dl>
1.1.1.5   root      123: 
1.1.1.2   root      124: <p>
1.1.1.8   root      125: nono のソースアーカイブを展開したら以下のようにビルドします。
1.1.1.23  root      126: <tt>-DRELEASE</tt> がないとハードモードになるので必ず指定してください。
                    127: <q>Extract the nono's source archive and build as following.
                    128: If you don't specify <tt>-DRELEASE</tt>, it will be hard mode.</q>
1.1.1.16  root      129: </p>
1.1.1.12  root      130: 
1.1       root      131: <blockquote class="cons"><pre>
1.1.1.16  root      132: % ./configure [&lt;options&gt;]
                    133: % make -DRELEASE depend
                    134: % make -DRELEASE
1.1.1.2   root      135: % su
                    136: # make install
1.1       root      137: </pre></blockquote>
1.1.1.2   root      138: 
                    139: <p>
1.1.1.16  root      140: configure には環境変数 CC、CXX でコンパイラを指定することが出来ます。
                    141: wx-config が標準的な名前で提供されていないために見付けられない場合には
                    142: 環境変数 WX_CONFIG にパスを指定することが出来ます。
                    143: また configure のオプションとして以下が指定できます。
                    144: <q>You can specify C/C++ compiler using environment variable CC and CXX
                    145: if configure cannot find standard name suitable compiler.
                    146: You can specify wx-config path using environment variable WX_CONFIG
                    147: if configure cannot find wx-config.
                    148: Also, you can specify the following option for <tt>configure</tt>.
                    149: </q>
                    150: <p>
                    151: <ul>
1.1.1.17  root      152: <li><tt>--disable-avx2</tt> …
1.1.1.16  root      153: amd64(x86_64) で AVX2 対応コードを無効にします。
                    154: デフォルトでは、コンパイラが AVX2 に対応していることを
                    155: configure が検出できれば AVX2 対応コードを生成します。
                    156: <q>Disable AVX2 support on amd64(x86_64).
                    157: By the default, it will generate AVX2 supported binary
1.1.1.17  root      158: only if configure detects that compiler supports AVX2.</q>
                    159: <li><tt>--disable-neon</tt> …
                    160: aarch64 で NEON 対応コードを無効にします。
                    161: デフォルトでは、コンパイラが NEON に対応していることを
                    162: configure が検出できれば NEON 対応コードを生成します。
                    163: <q>Disable NEON support on aarch64.
                    164: By the default, it will generate NEON supported binary
                    165: only if configure detects that compiler supports NEON.</q>
1.1.1.16  root      166: </ul>
                    167: <p>
                    168: <tt>make install</tt> により2つの実行ファイルがインストールされます。
1.1.1.2   root      169: <tt>nono</tt> が GUI 版実行ファイル、
                    170: <tt>nono-cli</tt> がコマンドライン版です。
1.1.1.16  root      171: <q><tt>make install</tt> will install two executables.
1.1.1.7   root      172: <tt>nono</tt> is the GUI executable and <tt>nono-cli</tt> is
                    173: the command line executable.</q>
1.1.1.16  root      174: </p>
1.1       root      175: </div>
1.1.1.14  root      176: <?php H4end(); ?>
1.1       root      177: 
                    178: 
1.1.1.14  root      179: <?php H4("execute", "実行方法 <q>How to execute</q>"); ?>
1.1.1.13  root      180: <div class="main">
1.1.1.14  root      181: nono は複数機種に対応しているため設定なしでは起動できません。
                    182: 設定は設定ファイルかコマンドラインオプションで指定します。
                    183: 詳細は以下の<a name="#configuration">設定</a>の章を参照してください。
                    184: <q>nono supports multiple architectures so that
                    185: it needs configuration.
                    186: See the following <a name="#configuration">Configuration</a> section for
                    187: details.</q>
1.1.1.13  root      188: </div>
                    189: 
1.1.1.14  root      190: <?php H5("commandline", "コマンドラインオプション <q>Command Line Option</q>");
                    191: ?>
1.1       root      192: <div class="main">
                    193: <dl>
                    194: <?php
                    195: function item($name, $desc)
                    196: {
                    197:        if (!is_array($name)) {
                    198:                $name = array($name);
                    199:        }
                    200:        foreach ($name as $n) {
                    201:                print "<dt class=dt-indent><tt>{$n}</tt></dt>\n";
                    202:        }
                    203:        print "<dd>{$desc}</p></dd>\n";
                    204: }
                    205: function option_item($name, $desc)
                    206: {
                    207:        item($name, $desc);
                    208: }
                    209: 
1.1.1.6   root      210: option_item("-c <i>vmpath</i>", <<<_EOM_
                    211: VM ディレクトリ/設定ファイルを指定します。
                    212: <i>vmpath</i> がディレクトリならそのディレクトリの中の nono.cfg
                    213: を設定ファイルとします。
                    214: <i>vmpath</i> がファイルならそれを設定ファイルとします。
                    215: そしていずれの場合も
                    216: 設定ファイルがあるディレクトリを VM ディレクトリとします。
                    217: -c オプションを省略すると <i>vmpath</i> をカレントディレクトリとします。
                    218: <q>Specifies the VM directory/configuration file.
                    219: If <i>vmpath</i> is a directory,
                    220: make nono.cfg in that directory a configuration file.
                    221: Or if <i>vmpath</i> is a file,
                    222: make the specified file a configuration file.
                    223: And in both cases,
                    224: make the directory where that file is located a VM directory.
                    225: If <tt>-c</tt> option is omitted,
1.1.1.11  root      226: <i>vmpath</i> is considered as the current directory.</q>
1.1       root      227: _EOM_
                    228: );
                    229: 
                    230: option_item("-f", <<<_EOM_
                    231: 高速モードで起動します。
                    232: GUI なら起動後にもメニューから変更できますが、その初期値を変えるだけです。
1.1.1.15  root      233: 設定の <tt>fast-mode=1</tt> と等価です。
1.1.1.2   root      234: <q>Boot as the fast mode.
                    235: You can change this mode on GUI menu after boot,
1.1.1.14  root      236: and the option only changes its initial state.
1.1.1.15  root      237: This option is equivalent to <tt>fast-mode=1</tt> in configuration.</q>
1.1       root      238: _EOM_
                    239: );
                    240: 
1.1.1.21  root      241: option_item("--fd0 <i>file</i><br>--fd1 <i>file</i>", <<<_EOM_
1.1.1.20  root      242: (X68030 Only) フロッピーイメージを指定します。
                    243: <i>file</i> が相対パスの場合カレントディレクトリからのパスになります。
                    244: 設定の <tt>fd0-image</tt>、<tt>fd1-image</tt>
                    245: とは相対パスの起点の違いを除いて同一です。
                    246: <q>Specifies the floppy image.
                    247: If <tt><i>file</i></tt> is relative path,
                    248: it is path from the current directory.
                    249: This option is equivalent to <tt>fd0-image</tt>, <tt>fd1-image</tt>
                    250: in configuration except for base directory of the relative path.</q>
                    251: _EOM_
                    252: );
                    253: 
1.1       root      254: option_item("--fontsize <i>height</i>", <<<_EOM_
                    255: GUI 版のみ。
                    256: 全サブウインドウの起動時のフォントサイズを指定します。
1.1.1.3   root      257: 起動後にメニューから変更できます。
1.1.1.15  root      258: 設定の <tt>monitor-fontsize</tt> と等価です。
1.1.1.14  root      259: <q>GUI Only.
                    260: Specifies the initial fontsize of all sub windows.
                    261: You can change this value on GUI menu after boot.
1.1.1.15  root      262: This option is equivalent to <tt>monitor-fontsize</tt> in configuration.</q>
1.1       root      263: _EOM_
                    264: );
                    265: 
1.1.1.17  root      266: option_item("--initrd <i>file</i>", <<<_EOM_
1.1.1.20  root      267: (virt-m68k Only)
1.1.1.16  root      268: カーネルに渡す初期 RAM ディスクのパスを指定します。
                    269: <i>file</i> が相対パスの場合カレントディレクトリからのパスになります。
                    270: 設定の <tt>exec-initrd</tt> とは相対パスの起点の違いを除いて同一です。
1.1.1.17  root      271: <q>Specifies the initial ramdisk image passed to the kernel.
1.1.1.16  root      272: If <tt><i>file</i></tt> is relative path,
                    273: it is path from the current directory.
                    274: This option is equivalent to <tt>exec-initrd</tt> in configuration
                    275: except for base directory of the relative path.</q>
                    276: _EOM_
                    277: );
                    278: 
1.1.1.14  root      279: option_item("-s <i>scale</i>", <<<_EOM_
1.1       root      280: GUI 版のみ。
                    281: メインウィンドウの起動時のスケールを実数で指定します。
1.1.1.14  root      282: 設定の <tt>mainview-scale</tt> と等価です。
                    283: 起動後はメニューからプリセットされた倍率と
1.1.1.15  root      284: <tt>mainview-scale</tt> で指定された倍率には変更可能です。
1.1.1.14  root      285: <q>GUI Only.
1.1.1.2   root      286: Specifies the initial main window scale in real number.
1.1.1.15  root      287: This is equivalent to <tt>mainview-scale</tt> in configuration.
1.1.1.14  root      288: You can change this scale on GUI menu after boot.</q>
1.1       root      289: _EOM_
                    290: );
                    291: 
                    292: option_item("--show-config", <<<_EOM_
                    293: 設定ファイルと <tt>-V</tt> オプションを読み込んだ結果を表示します。
1.1.1.2   root      294: <q>Shows the result of reading configuration file and
                    295: parsing <tt>-V</tt> options.</q>
1.1       root      296: _EOM_
                    297: );
                    298: 
                    299: option_item("-v", <<<_EOM_
                    300: バージョンを表示します。
1.1.1.2   root      301: <q>Shows the version.</q>
1.1       root      302: _EOM_
                    303: );
                    304: 
                    305: option_item("-V <i>name</i>=<i>value</i>", <<<_EOM_
1.1.1.3   root      306: 設定ファイルで指定した <tt><i>name</i>=<i>configvalue</i></tt> の代わりに
1.1.1.2   root      307: このオプションの <tt><i>name</i>=<i>value</i></tt> を適用します。
1.1.1.12  root      308: <tt><i>name</i></tt> が正しくない場合はエラー終了します。
1.1.1.3   root      309: <q>Use this <i>name</i>=<i>value</i>
1.1.1.12  root      310: instead of <i>name</i>=<i>configvalue</i> specified in configuration file.
                    311: If <tt><i>name</i></tt> is not correct, it will exit on error.</q>
1.1       root      312: _EOM_
                    313: );
1.1.1.9   root      314: 
                    315: option_item("-X <i>file</i>", <<<_EOM_
                    316: ホストの <tt><i>file</i></tt> をロードして実行します。
                    317: <tt><i>file</i></tt> が相対パスの場合カレントディレクトリからのパスになります。
1.1.1.17  root      318: 設定の <tt>exec-file</tt> とは相対パスの起点の違いを除いて同一です。
1.1.1.9   root      319: ファイルが gzip 圧縮されていれば自動的に展開します。
1.1.1.14  root      320: (展開後の) ファイル形式は以下の通りですが、
1.1.1.9   root      321: 実際にはブートローダとカーネル程度しか想定していません。
1.1.1.14  root      322: また、いずれも起動元デバイスが取得できないなどの問題はあるかも知れません。
1.1.1.9   root      323: <q>Loads and executes host's <tt><i>file</i></tt>.
                    324: If <tt><i>file</i></tt> is relative path,
                    325: it is path from the current directory.
1.1.1.17  root      326: This option is equivalent to <tt>exec-file</tt> in configuration
                    327: except for base directory of the relative path.
1.1.1.9   root      328: If the file is gzip'd, it is automatically extracted.
1.1.1.14  root      329: The supported file format (after extracting) is the following.
1.1.1.9   root      330: Actually, it only assumes bootloaders or kernels.
1.1.1.14  root      331: And note that it may not obtain some information that where did I boot from,
                    332: for example.</q>
                    333: <ul>
                    334: <li>a.out (OMAGIC) 実行ファイル (おそらくブートローダのみサポート)
                    335: <q>a.out (OMAGIC) executable (It probably supports bootloaders only)</q>
                    336: <li>ELF 実行ファイル
                    337: (おそらくカーネルのみサポート。
                    338: NetBSD の実行ファイルのようであれば、
                    339: カーネルだと思ってシンボルテーブルも読み込みます)
                    340: <q>ELF executable
                    341: (It probably supports the kernel only.
                    342: If the file is assumed to be NetBSD executable,
                    343: it will also load symbol tables as the bootloader does to the kernel.)</q>
                    344: <li>ELF object (Experimental)
                    345: </ul>
1.1.1.16  root      346: LUNA では設定の <tt>prom-image</tt> (後述) によらず内蔵の互換 ROM で起動します。
                    347: <tt>luna-dipsw1</tt> の DIPSW 設定が
                    348: <tt>dipsw-autoboot=yes</tt> 相当の状態ならそのまま直ちにホストファイルを実行し、
                    349: そうでなければ互換 ROM のプロンプトで停止します。
                    350: 後者の場合でも LUNA-I なら "g" コマンド、LUNA-88K なら "b" コマンドによる
                    351: ロードはここで指定したホストファイルをロードします。
1.1.1.14  root      352: X68030 では、IPLROM 起動の後の起動デバイスに細工がしてあり、
                    353: そこからホストファイルを実行します。
1.1.1.17  root      354: virt-m68k (と NEWS) はこの方法でしか起動できませんので、
                    355: 実行ファイルの指定は必須になります。
                    356: <q>On LUNA,
1.1.1.16  root      357: regardless of <tt>prom-image</tt> configuration (see below),
                    358: it boots the internal emulated PROM.
                    359: If <tt>luna-dipsw1</tt> configuration meets <tt>dipsw-autoboot=yes</tt>,
                    360: it will immediately load and execute the host file.
                    361: Otherwise, it will wait in prompt.
                    362: Even in this case, "g" command (in LUNA-I) or "b" command (in LUNA-88K)
                    363: will load the host file that is specified by this option.
1.1.1.14  root      364: On X68030,
                    365: nono hacks the boot device after normal boot from IPLROM,
1.1.1.16  root      366: and loads and executes the host file.
1.1.1.17  root      367: On virt-m68k (and NEWS), this is the only way to boot.</q>
1.1.1.9   root      368: _EOM_
                    369: );
1.1       root      370: ?>
                    371: </dl>
                    372: 
1.1.1.2   root      373: 以下開発用。<q>For developers:</q>
1.1       root      374: <dl>
                    375: <?php
                    376: // 項目間を空けない
                    377: function option_dev($name, $desc)
                    378: {
                    379:        print "<dt class=dt-indent><tt>{$name}</tt></dt>\n";
                    380:        print "<dd>{$desc}</dd>\n";
                    381: }
                    382: 
1.1.1.22  root      383: option_dev("-b,--b <i>hexaddr</i>[,<i>skipcount</i>]", <<<_EOM_
1.1       root      384: デバッガのブレークポイントを 16進数で指定します。
                    385: _EOM_
                    386: );
                    387: 
1.1.1.22  root      388: option_dev("--bi <i>inst</i>[:<i>mask</i>][,<i>skipcount</i>]",
                    389: <<<_EOM_
                    390: デバッガの命令ブレークポイントを指定します。
                    391: _EOM_
                    392: );
                    393: 
                    394: option_dev("--bv <i>vector</i>[,<i>skipcount</i>]", <<<_EOM_
                    395: デバッガの例外ブレークポイントを指定します。
                    396: _EOM_
                    397: );
                    398: 
1.1       root      399: option_dev("-C", <<<_EOM_
                    400: ログをコンソールにも出力します。
                    401: 通常はログウィンドウにだけ出力されます。
                    402: _EOM_
                    403: );
                    404: 
                    405: option_dev("-d", <<<_EOM_
                    406: 起動時にデバッガプロンプトで停止します。
                    407: _EOM_
                    408: );
                    409: 
                    410: option_dev("-D", <<<_EOM_
                    411: コンソールをデバッガとして使用します。
1.1.1.12  root      412: 過去との互換性のために存在していますが、
                    413: <tt>-V debugger-driver=stdio</tt> と等価です。
1.1       root      414: _EOM_
                    415: );
                    416: 
1.1.1.17  root      417: $hlink = linkto_str("human", "human.html");
                    418: option_dev("-H", "Human68k モードです。→ {$hlink}");
                    419: 
1.1       root      420: option_dev("-L <i>name1</i>=<i>level1</i>[,<i>name2</i>=<i>level2</i>,...]",
                    421: <<<_EOM_
                    422: ログレベルを指定します。
                    423: カンマで区切って複数指定することも出来ます。
                    424: <tt>-Lhelp</tt> で name の一覧を表示します。
                    425: _EOM_
                    426: );
                    427: 
                    428: option_dev("-M <i>name</i>[,<i>name2</i>,...]", <<<_EOM_
                    429: 起動時に表示するモニタウィンドウを指定します。
                    430: カンマで区切って複数指定することも出来ます。
1.1.1.3   root      431: <tt>-Mhelp</tt> で name の一覧を表示します。
1.1       root      432: _EOM_
                    433: );
                    434: 
                    435: 
                    436: ?>
                    437: </dl>
                    438: </div>
1.1.1.14  root      439: <?php H5end(); ?>
                    440: <?php H4end(); ?>
1.1       root      441: 
1.1.1.7   root      442: 
1.1.1.14  root      443: <?php H4("configuration", "設定 <q>Configuration</q>"); ?>
1.1       root      444: <div class="main">
1.1.1.14  root      445: nono の設定はいずれも以下の順序で適用されます。
                    446: <q>nono's configurations are always applied in the following order.</q>
1.1.1.15  root      447: <ol>
1.1.1.14  root      448: <li>デフォルト値 <q>Default value</q>
                    449: <li>~/.nono.cfg があればその内容
                    450: <q>Contents of ~/.nono.cfg if exists</q>
                    451: <li>VM ディレクトリ内の nono.cfg (または -c で指定したファイル)
                    452: があればその内容
                    453: <q>Contents of nono.cfg in the VM directory (or the file specified by -c option) if exists</q>
                    454: <li>コマンドラインオプション <q>Command line option</q>
                    455: </ol>
                    456: ファイルの書式はどちらも <tt>key = value</tt> 形式で1行1項目ずつです。
1.1       root      457: <tt>key</tt> と <tt>value</tt> の前後の空白は取り除かれます。
                    458: また空行と "<tt>#</tt>" で始まる行は無視します。
1.1.1.12  root      459: 知らないキーは警告を出した上で無視します。
1.1.1.14  root      460: 同じキーが複数回現れた場合、
                    461: 上に列挙した順に後から書いたほうで上書きし、
                    462: 同じファイル内でも同様に後に書いたほうで上書きします。
                    463: コマンドラインオプション <tt>-V</tt> 等はこれをさらに上書きします。
                    464: コマンドラインオプションで同じキーが複数回現れた場合も後に書いたほうが上書きします。
                    465: <q>
                    466: The syntax of both files is <tt>key = value</tt> format, one per line.
1.1.1.2   root      467: White spaces before and after <tt>key</tt> and <tt>value</tt> are ignored.
1.1.1.12  root      468: Blank lines, lines beginning with "<tt>#</tt>" are also ignored.
1.1.1.14  root      469: The lines with unrecognized key are ignored with a warning.
                    470: 
                    471: If the same key appears more than once,
                    472: the latter overwrites the former in the above order.
                    473: If the same key appears in a file,
                    474: the latter overwrites the former in the same manner.
1.1.1.16  root      475: Then, command line option <tt>-V</tt> etc. overwrites them.
1.1.1.14  root      476: If the same key appears more than once in the command line option,
                    477: do in the same manner.</q>
                    478: <p>
                    479: <tt>vmtype</tt> を除くすべての設定項目はそれぞれデフォルト値を持っています。
                    480: つまり少なくとも <tt>vmtype</tt> だけは設定ファイルかコマンドラインオプションで指定する必要があります。
                    481: <q>All configuration items except <tt>vmtype</tt> have default value.
1.1.1.17  root      482: It means, you need to specify at least only <tt>vmtype</tt>
1.1.1.14  root      483: by configuration file or commandline option.</q>
1.1       root      484: <p>
                    485: 設定項目は次の通りです。
1.1.1.2   root      486: <q>The configuration items are:</q>
1.1       root      487: <dl>
                    488: <?php
                    489: function config_item($name, $desc)
                    490: {
                    491:        item($name, $desc);
                    492: }
                    493: 
                    494: config_item("vmtype = <i>string</i>", <<<_EOM_
1.1.1.4   root      495: VM 種別を以下のいずれかから指定します。
                    496: 省略不可です。
                    497: <q>Specifies the VM type from the following.
1.1.1.11  root      498: This field is mandatory.</q>
1.1.1.4   root      499: <table cellspacing=0 cellpadding=0>
1.1.1.17  root      500: <tr><td>&nbsp;<td><tt>luna</tt>        <td>&nbsp;… LUNA-I
                    501: <tr><td><td><tt>luna88k</tt>   <td>&nbsp;… LUNA-88K
                    502: <tr><td><td><tt>x68030</tt>            <td>&nbsp;… X68030
                    503: <tr><td><td><tt>news</tt>              <td>&nbsp;… NWS-1750 (Just a joke)
                    504: <tr><td><td><tt>virt-m68k</tt> (or <tt>virt68k</tt>) <td>&nbsp;… virt-m68k
1.1.1.4   root      505: </table>
1.1       root      506: _EOM_
                    507: );
                    508: 
1.1.1.14  root      509: config_item("cgrom-image = <i>path</i>", <<<_EOM_
1.1.1.13  root      510: (X68030 Only)
                    511: X68030 の外部 CGROM イメージファイルのパスを指定します。
                    512: CGROM は 768KB です。
                    513: <i>path</i> がファイル名のみなら VM ディレクトリとその親ディレクトリからこのファイル名を検索します。
                    514: <i>path</i> が相対パスなら VM ディレクトリからの相対パスになります (現在のディレクトリからではありません)。
                    515: 空にすると nono 内蔵の互換 CGROM を使用します。
                    516: デフォルトは空です。
                    517: <q>Specifies the X68030's external CGROM image file path.
                    518: This CGROM is 768KB.
                    519: If the <i>path</i> does not have any path delimiters,
                    520: the VM directory and then its parent directory will be searched.
                    521: If the <i>path</i> is a relative path,
                    522: it will be path from the VM directory, not from the current directory.
                    523: If the <i>path</i> is empty, nono's builtin compatible CGROM will be used.
1.1.1.14  root      524: The default value is empty.</q>
1.1.1.13  root      525: _EOM_
                    526: );
                    527: 
1.1.1.8   root      528: config_item("clock-sync = <i>value</i>", <<<_EOM_
                    529: 仮想マシン内の時刻の同期方法を指定します。
                    530: <tt>real</tt> なら実時間に同期、<tt>virtual</tt> なら仮想時間に同期します。
1.1.1.20  root      531: <q>Specifies how to synchronize the time in the virtual machine.
1.1.1.24! root      532: <tt>real</tt> means synchronizing with the real time.
        !           533: <tt>virtual</tt> means synchronizing with the virtual time.</q>
1.1.1.20  root      534: <ul>
                    535: <li>LUNA-I では 60Hz のシステムクロック割り込みと RTC(MK48T02) が対象で、
                    536: デフォルトは <tt>real</tt> です。
                    537: <q>On LUNA-I, 60Hz system clock interrupt and RTC(MK48T02) are the target.
                    538: The default is <tt>real</tt>.</q>
                    539: <li>LUNA-88K では 100Hz のシステムクロック割り込みと RTC(MK48T02) が対象で、
                    540: デフォルトは <tt>real</tt> です。
                    541: <q>On LUNA-88K, 100Hz system clock interrupt and RTC(MK48T02) are the target.
                    542: The default is <tt>real</tt>.</q>
                    543: <li>NWS-1750 ではシステムクロック割り込みと RTC(MK48T02) が対象で、
                    544: デフォルトは <tt>real</tt> です。
                    545: <q>On NWS-1750, system clock interrupt and RTC(MK48T02) are the target.
                    546: The default is <tt>real</tt>.</q>
                    547: <li>virt-m68k では Goldfish Timer の割り込みと Goldfish RTC が対象で、
                    548: デフォルトは <tt>real</tt> です。
                    549: <q>On virt-m68k, Goldfish Timer interrupt and Goldfish RTC are the target.
                    550: The default is <tt>real</tt>.</q>
1.1.1.21  root      551: <li>X68030 では MFP のタイマー割り込みと RTC(RP5C15) が対象で、
1.1.1.20  root      552: デフォルトは <tt>virtual</tt> です。
                    553: MFP の TxDR レジスタの読み出しは、
                    554: この指定に関わらず常に <tt>virtual</tt> 相当の動作しか出来ません。
                    555: <a href="#netbsd-x68k-timesync">NetBSD/x68k での時間同期</a> の項も参照してください。
                    556: <q>On X68030, MFP timer interrupts and RTC(RP5C15) are the target.
                    557: The default is <tt>virtual</tt>.
                    558: Note that reading from MFP TxDR register only works as <tt>virtual</tt>,
                    559: regardless of this setting.
                    560: See also <a href="#netbsd-x68k-timesync">Time Synchronization on NetBSD/x68k</a>.</q>
                    561: </ul>
1.1.1.8   root      562: _EOM_
                    563: );
                    564: 
1.1.1.13  root      565: config_item("debugger-driver = <i>string</i>", <<<_EOM_
1.1.1.12  root      566: デバッガのコンソールドライバを指定します。
                    567: <tt>stdio</tt>、<tt>tcp</tt>、<tt>none</tt> が選択可能です。
                    568: <tt>stdio</tt> は標準入出力を使用します。
                    569: <tt>tcp</tt> は TCP ポートで TELNET プロトコルで待ち受けます。
                    570: <tt>none</tt> ならホスト側とは一切通信を行いません。
                    571: デフォルトは <tt>none</tt> です。
                    572: <q>Specifies console driver of the debugger.
                    573: <tt>stdio</tt>, <tt>tcp</tt>, and <tt>none</tt> can be specified.
                    574: <tt>stdio</tt> uses the standard input/output.
                    575: <tt>tcp</tt> listens on TCP port using TELNET protocol.
                    576: <tt>none</tt> doesn't make any communication with the host.
                    577: The default is <tt>none</tt>.</q>
                    578: _EOM_
                    579: );
                    580: 
1.1.1.13  root      581: config_item("debugger-tcp-port = <i>integer</i>",
1.1.1.12  root      582: <<<_EOM_
                    583: デバッガのコンソールドライバが tcp の時の TCP 待ち受けポート番号を指定します。
1.1.1.14  root      584: <q>Specifies the TCP port number that debugger console driver listens.</q>
                    585: _EOM_
                    586: );
                    587: 
                    588: ?><a name="config-dipsw-autoboot"></a><?php
                    589: config_item("dipsw-autoboot = <i>yesno</i>", <<<_EOM_
                    590: (LUNA and NEWS Only)
                    591: 機種に依存せず DIPSW を自動起動に設定するかどうか指定します。
                    592: "<tt>yes</tt>" なら自動起動するように、
                    593: "<tt>no</tt>" なら自動起動しないように DIPSW 設定を上書きします。
                    594: "" (空) なら何もしません。デフォルトは "" です。
                    595: このオプションは <tt>luna-dipsw1</tt> や <tt>news-dipsw</tt>
                    596: の状態が設定ファイルやコマンドラインオプションによって確定した後に
                    597: 該当のスイッチだけを変更します。
                    598: <q>Specifies whether to configure DIPSW to boot automatically,
                    599: regardless of the models.
                    600: "<tt>yes</tt>" overwrites DIPSW, to boot automatically.
                    601: "<tt>no</tt>" overwrites DIPSW, not to boot automatically.
                    602: "" (Empty) does nothing.
                    603: The default value is "".
                    604: This option only changes the appropriate switch(es)
                    605: after the <tt>luna-dipsw1</tt> or <tt>news-dipsw</tt> configuration
                    606: is determined by the configuration file or command line options.</q>
                    607: _EOM_
                    608: );
                    609: 
                    610: config_item("dipsw-serial = <i>yesno</i>", <<<_EOM_
                    611: (LUNA and NEWS Only)
                    612: 機種に依存せず DIPSW をシリアルコンソールを使うかどうか指定します。
                    613: "<tt>yes</tt>" ならシリアルコンソールを使うように、
                    614: "<tt>no</tt>" ならシリアルコンソールを使わないように DIPSW 設定を上書きします。
                    615: "" (空) なら何もしません。デフォルトは "" です。
                    616: <tt>luna-dipsw1</tt> もしくは <tt>news-dipsw</tt> (機種による)
                    617: の状態が設定ファイルやコマンドラインオプションによって確定した後に
                    618: このオプションによって該当のスイッチだけを変更します。
                    619: NEWS でシリアルコンソールを使わないを選択した場合、
                    620: SW1,2,3 は OFF, OFF, ON にセットされ、
                    621: NWB-512 モノクロコンソール(未実装) が選択されます。
                    622: <q>Specifies whether to configure DIPSW to use serial console,
                    623: regardless of the models.
                    624: "<tt>yes</tt>" overwrites DIPSW, to use serial console.
                    625: "<tt>no</tt>" overwrites DIPSW, not to use serial console.
                    626: "" (Empty) does nothing.
                    627: The default value is "".
                    628: This option only changes the appropriate switch(es)
                    629: after the <tt>luna-dipsw1</tt> or <tt>news-dipsw</tt> configuration
                    630: is determined by the configuration file or command line options.
                    631: If you choose not to use serial console on NEWS,
                    632: SW1,2,3 will be set OFF, OFF, ON respectively,
                    633: and NWB-512 monochrome console (not implemented) will be chosen.</q>
1.1       root      634: _EOM_
                    635: );
                    636: 
1.1.1.15  root      637: config_item(
                    638:        "ethernet-macaddr = <i>string</i><br>" .
1.1.1.16  root      639:        "ethernet<i>N</i>-macaddr = <i>string</i><br>",
1.1.1.15  root      640: <<<_EOM_
1.1.1.16  root      641: <i>N</i>
                    642: 番目のイーサネットデバイスの仮想マシン側の MAC アドレスを指定します。
1.1.1.8   root      643: <tt><i>XX</i>:<i>XX</i>:<i>XX</i>:<i>XX</i>:<i>XX</i>:<i>XX</i></tt>
                    644: 形式で指定します。
                    645: <tt>auto</tt> なら自動的に決定します。
                    646: デフォルトは <tt>auto</tt> です。
1.1.1.16  root      647: <tt>ethernet-macaddr</tt> は <tt>ethernet0-macaddr</tt> の別名です。
                    648: _EOM_
                    649: );
                    650: 
1.1.1.17  root      651: config_item("exec-file = <i>path</i>", <<<_EOM_
1.1.1.16  root      652: 起動時にロードするホストの実行ファイルを指定します。
                    653: -X オプションとほぼ同等ですが、相対パスは VM ディレクトリを起点にします。
                    654: <q>Specifiies the host file that will be loaded at startup.
                    655: This is mostly the same as -X option.
                    656: The only one difference is that relative path originates the VM directory.</q>
                    657: _EOM_
                    658: );
                    659: 
1.1.1.19  root      660: config_item("exec-bootparam = <i>string</i>", <<<_EOM_
1.1.1.18  root      661: (virt-m68k Only)
                    662: カーネルに渡すブートパラメータを指定します。
                    663: 内容はたぶん OS ごとに異なりますが、
                    664: NetBSD/virt68k では "<tt>root=ld0</tt>" (クォートを除く)
                    665: のようにしてカーネルにルートデバイスを指示します。
                    666: <q>Specifies the boot parameter that is passed to the kernel.
                    667: The syntax may differ depending on the OS, but in NetBSD/virt68k,
                    668: you can specify the root device to the kernel, like as
                    669: "<tt>root=ld0</tt>" (excluding quotes).</q>
                    670: _EOM_
                    671: );
                    672: 
1.1.1.17  root      673: config_item("exec-initrd = <i>path</i>", <<<_EOM_
                    674: (virt-m68k Only)
1.1.1.16  root      675: カーネルに渡す初期 RAM ディスクイメージのパスを指定します。
                    676: --initrd オプションとほぼ同等ですが、相対パスは VM ディレクトリを起点にします。
                    677: <q>Specifies the initial ramdisk image passed to the kernel.
                    678: This is mostly the same as --initrd option.
                    679: The only one difference is that relative path originates the VM directory.</q>
1.1.1.8   root      680: _EOM_
                    681: );
                    682: 
1.1.1.15  root      683: config_item("extram-size = <i>integer</i>", <<<_EOM_
1.1.1.14  root      684: (X68030 Only)
                    685: 拡張メモリのサイズを MB 単位で指定します。
                    686: 今の所以下だけが指定できます。
                    687: <q>Specifies the extended RAM size in MB.
                    688: For now, only the following can be specified.</q>
1.1.1.15  root      689: <ul>
1.1.1.14  root      690: <li><tt>0</tt> … 拡張メモリを使用しません。デフォルトです。
                    691: <q>No extended memory.  It's default.</q>
                    692: <li><tt>16</tt> … TS-6BE16 互換モードで、
1.1.1.16  root      693: アドレス $0100'0000 からの 16MB です。
1.1.1.14  root      694: <q>TS-6BE16 compatible mode.
1.1.1.16  root      695: Its address is from $0100'0000 and the size is 16MB.</q>
                    696: <li><tt>128/256/512</tt> … 060turbo 互換モードで、
                    697: アドレス $1000'0000 からです。
                    698: <q>060turbo compatible mode.  Its address is from $1000'0000.</q>
1.1.1.15  root      699: </ul>
1.1.1.14  root      700: _EOM_
                    701: );
                    702: 
1.1.1.15  root      703: config_item("fast-mode = <i>integer</i>", <<<_EOM_
1.1.1.14  root      704: 起動時の動作モードを指定します。0 なら通常モード、1 なら高速モードです。
                    705: デフォルトは 0 です。
                    706: コマンドラインオプション <tt>-f</tt> でも高速モードへのみ指定可能です。
                    707: _EOM_
                    708: );
                    709: 
                    710: config_item("fd-drive = <i>integer</i>", <<<_EOM_
                    711: (X68030 Only)
1.1.1.13  root      712: フロッピードライブの数を 0 から 4 で指定します。
                    713: デフォルトは 2 です。
1.1.1.14  root      714: <q>Specifies the number of floppy drives from <tt>0</tt> to <tt>4</tt>.
1.1.1.13  root      715: The default is <tt>2</tt>.</q>
                    716: _EOM_
                    717: );
                    718: 
1.1.1.14  root      719: config_item("fd<i>N</i>-image = <i>path</i>", <<<_EOM_
                    720: (X68030 Only)
1.1.1.24! root      721: フロッピードライブ <i>N</i> に起動時に挿入する
        !           722: <a href="#diskimage">ディスクイメージ</a>を指定します。
1.1.1.13  root      723: イメージパスが相対パスなら VM ディレクトリからの相対パスになります。
                    724: 起動後はメニューから操作できます。
                    725: デフォルトは空です。
1.1.1.14  root      726: <q>Specifies a diskimage to be inserted to floppy drive <i>N</i> at startup.
1.1.1.13  root      727: If the <i>path</i> is relative path, it is from the VM directory.
                    728: You can also operate them from menu after startup.
                    729: The default is empty.</q>
                    730: _EOM_
                    731: );
                    732: 
1.1.1.14  root      733: config_item("fpu-type = <i>value</i>", <<<_EOM_
1.1.1.19  root      734: (X68030 and virt-m68k Only)
1.1.1.18  root      735: 68030 に FPU コプロセッサを装着するかどうか指定しています。
1.1.1.19  root      736: この設定は <tt>mpu-type</tt> が <tt>68030</tt> の時のみ有効です。
1.1.1.18  root      737: <tt>none</tt> なら FPU コプロセッサを装着しません。
                    738: <tt>68881</tt> なら FPU コプロセッサとして 68881 を装着します。
1.1.1.13  root      739: 現状 68882 はサポートしていません。
                    740: また <tt>none</tt> の代わりに <tt>0</tt>、
                    741: <tt>68881</tt> の代わりに <tt>1</tt> と書くこともできます。
                    742: デフォルトは <tt>68881</tt> です。
1.1.1.18  root      743: LUNA-I はたぶん 68881 搭載モデルのみのため変更できません。
                    744: <q>Specifies whether to install FPU co-processor or not.
1.1.1.19  root      745: This item is meaningful only if <tt>mpu-type</tt> is <tt>68030</tt>.
1.1.1.24! root      746: If set to <tt>none</tt>, FPU co-processor is not installed.
        !           747: If set to <tt>68881</tt>, 68881 FPU co-processor is installed.
1.1.1.13  root      748: 68882 is not supported yet.
                    749: And, <tt>none</tt> can also be written as <tt>0</tt>,
                    750: <tt>68881</tt> can also be written as <tt>1</tt>.
                    751: The default is <tt>68881</tt>.
                    752: This item cannot be specified on LUNA-I
1.1.1.18  root      753: because (probably) all LUNA-I has 68881.</q>
1.1.1.16  root      754: _EOM_
                    755: );
                    756: 
1.1.1.22  root      757: config_item(
1.1.1.21  root      758:        "hostcom-driver = <i>string</i><br>" .
                    759:        "hostcom-tcp-port = <i>integer</i><br>" .
                    760:        "hostcom-fallback = <i>integer</i>", <<<_EOM_
                    761: それぞれ <tt>hostcom0-*</tt> の別名です。
                    762: <q>These are aliases for <tt>hostcom0-*</tt> respectively.</q>
                    763: _EOM_
                    764: );
                    765: 
                    766: config_item("hostcom<i>N</i>-driver = <i>string</i>", <<<_EOM_
1.1.1.22  root      767: 起動時のシリアルポート <i>N</i> のホスト側ドライバを指定します。
1.1.1.18  root      768: <tt>stdio</tt> なら標準入出力を使用します。
                    769: <tt>tcp</tt> なら TCP ポートで TELNET プロトコルで待ち受けます。
1.1.1.21  root      770: <tt>console</tt> (または <tt>cons</tt>)
                    771: ならメイン画面で端末エミュレーションを行います。
1.1.1.12  root      772: <tt>none</tt> ならホスト側とは一切通信を行いません。
1.1.1.22  root      773: <q>Specifies the host driver of serial port <i>N</i> on startup.
1.1.1.12  root      774: <tt>stdio</tt> uses the standard input/output.
                    775: <tt>tcp</tt> listens on TCP port using TELNET protocol.
1.1.1.21  root      776: <tt>console</tt> (or <tt>cons</tt>) does a terminal emulation in main panel.
                    777: <tt>none</tt> doesn't make any communication with the host.</q>
                    778: <p>
                    779: <tt>hostcom<i>N</i></tt> と
                    780: VM 内のデバイス(ポート)との対応は下表の通り VM 種別ごとに固定です。
                    781: <q>The correspondence between <tt>hostcom<i>N</i></tt> and
                    782: device (port) in the VM is fixed depending on the VM type
                    783: as the following table.</q>
                    784: <center>
                    785: <table cellspacing=0 border=1 rules=all>
                    786: <tr><th>hostcom\VM<th>LUNA-I/LUNA-88K<th>X68030<th>NWS-1750<th>virt-m68k
                    787: <tr><th>hostcom0
                    788:  <td align=center>SIO(uPD7201) Ch.A
                    789:  <td align=center>SCC(Z8530) Ch.A
                    790:  <td align=center>SCC(Z8530) Ch.A
                    791:  <td align=center>Goldfish TTY
1.1.1.22  root      792: <tr><th>hostcom1
                    793:  <td align=center>HD647180 ASCI Ch.0
                    794:  <td align=center>N/A
                    795:  <td align=center>N/A
                    796:  <td align=center>N/A
                    797: <tr><th>hostcom2
                    798:  <td align=center>HD647180 ASCI Ch.1
                    799:  <td align=center>N/A
                    800:  <td align=center>N/A
                    801:  <td align=center>N/A
1.1.1.21  root      802: </table>
                    803: </center>
                    804: <p>
                    805: また、VM 種別によって有効なホスト側ドライバの種類とデフォルト値も異なります。
                    806: <q>The choices and default value vary depending on the VM type.</q>
                    807: <center>
                    808: <table cellspacing=0 border=1 rules=all>
                    809: <tr><th>VM<th>LUNA-I/LUNA-88K<th>X68030<th>NWS-1750<th>virt-m68k
                    810: <tr><th>有効なドライバ<br><q>Available drivers</q>
                    811:  <td align=center>stdio<br>tcp<br>none<br>
                    812:  <td align=center>stdio<br>tcp<br>none<br>
                    813:  <td align=center>stdio<br>tcp<br>console<br>none
                    814:  <td align=center>stdio<br>tcp<br>console<br>none
                    815: <tr><th>hostcom0-driver のデフォルト値<br><q>Default value</q>
                    816:  <td align=center>none
                    817:  <td align=center>none
                    818:  <td align=center>console
                    819:  <td align=center>console
1.1.1.22  root      820: <tr><th>hostcom[12]-driver のデフォルト値<br><q>Default value</q>
                    821:  <td align=center>none
                    822:  <td align=center>N/A
                    823:  <td align=center>N/A
                    824:  <td align=center>N/A
1.1.1.21  root      825: </table>
                    826: </center>
                    827: <p>
                    828: 指定したドライバが使用出来なかった場合エラー終了します。
                    829: 起動後はメニューからドライバを変更できますが、パラメータは(まだ?)変更できません。
                    830: 実行中に変更に失敗した場合は none にフォールバックします。
                    831: <q>Terminate if the specified driver could not be used.
                    832: You can change the driver by menu at runtime,
                    833: but its parameters cannot be changed (yet?).
                    834: If changing at runtime fails, it will fallback to none.</q>
1.1.1.12  root      835: _EOM_
                    836: );
                    837: 
1.1.1.21  root      838: config_item("hostcom<i>N</i>-tcp-port = <i>integer</i>", <<<_EOM_
1.1.1.12  root      839: ホストドライバが tcp の時の TCP 待ち受けポート番号を指定します。
1.1.1.14  root      840: <q>Specifies the TCP port number that host driver listens.</q>
1.1.1.12  root      841: _EOM_
                    842: );
                    843: 
1.1.1.24! root      844: config_item("hostcpu-avx2 = <i>string</i>", <<<_EOM_
1.1.1.23  root      845: ホストが amd64(x86_64) の場合にレンダリングに AVX2
                    846: アクセラレーションを使うかどうかを指定します。
                    847: <tt>auto</tt> なら起動時にホスト CPU が AVX2 をサポートしているか確認し、
                    848: サポートしていれば使用します。
                    849: <tt>no</tt> なら AVX2 コードを実行しません。
                    850: デフォルトは <tt>auto</tt> です。
                    851: amd64(x86_64) 以外のホストではこの設定は無視されます。
                    852: <q>Specifies whether to use AVX2 acceleration for rendering
                    853: on amd64(x86_64) host.
1.1.1.24! root      854: If set to <tt>auto</tt>, nono checks whether the host CPU supports AVX2
1.1.1.23  root      855: on startup and use it if it does.
1.1.1.24! root      856: If set to <tt>no</tt>, nono will not execute AVX2 instructions.
1.1.1.23  root      857: The default is <tt>auto</tt>.
                    858: Note that this item is ignored if the host is not amd64(x86_64).
                    859: _EOM_
                    860: );
                    861: 
1.1.1.24! root      862: config_item("hostcpu-neon = <i>string</i>", <<<_EOM_
1.1.1.23  root      863: ホストが aarch64 の場合にレンダリングに NEON
                    864: アクセラレーションを使うかどうかを指定します。
                    865: <tt>auto</tt> なら使用し、
                    866: <tt>no</tt> なら使用しません。
                    867: デフォルトは <tt>auto</tt> です。
                    868: aarch64 以外のホストではこの設定は無視されます。
                    869: <q>Specifies whether to use NEON acceleration for rendering
                    870: on aarch64 host.
1.1.1.24! root      871: If set to <tt>auto</tt>, nono uses NEON code.
        !           872: If set to <tt>no</tt>, nono don't use NEON code.
1.1.1.23  root      873: The default is <tt>auto</tt>.
                    874: Note that this item is ignored if the host is not aarch64.
                    875: _EOM_
                    876: );
                    877: 
1.1.1.24! root      878: config_item("hostcpu-fastcore = <i>string</i>", <<<_EOM_
1.1.1.23  root      879: ホストの CPU がヘテロジニアス構成の場合の高性能コアを列挙します。
                    880: コアの番号は <tt>0,1,2</tt> のようにカンマ区切りで指定します。
                    881: ハイフンで範囲指定も出来ます。
                    882: <tt>-2,3,4-7</tt> は <tt>0-7</tt> と等価です。
                    883: どのコアが高性能コアかは dmesg 等で調べてください。
                    884: どのスレッドを割り当てるかはユーザは指定できません。
                    885: コアが一つも指定されないかすべてのコアが指定された場合はホモジニアス構成とみなします。
                    886: <tt>auto</tt> と書くと自動判別ですが現状 Intel CPU のみ対応しています。
                    887: 対称構成の CPU なら指定不要です。
                    888: デフォルトは <tt>auto</tt> です。
                    889: _EOM_
                    890: );
                    891: 
1.1.1.10  root      892: config_item("hostkbd-input = <i>string</i>", <<<_EOM_
1.1.1.20  root      893: (LUNA and X68030 Only)
1.1.1.10  root      894: ホストキーボードの入力モードを指定します。
                    895: <tt>char</tt> ならキャラクタ入力モード、
                    896: <tt>jp</tt> なら日本語キーボードモードです。
                    897: デフォルトは <tt>char</tt> です。
                    898: 詳細は <a href="#aboutvm">VM について</a> の章を参照してください。
                    899: <q>Specifies the input mode of the host keyboard.
                    900: <tt>char</tt> means the character mode,
                    901: <tt>jp</tt> means the Japanese keyboard mode.
                    902: The defualt is <tt>char</tt>.
                    903: See <a href="#aboutvm">About VM</a> for details.</q>
                    904: _EOM_
                    905: );
                    906: 
1.1.1.16  root      907: config_item(
                    908:        "hostnet-driver = <i>string</i><br>" .
                    909:        "hostnet-afpacket-ifname = <i>ifname</i><br>" .
                    910:        "hostnet-bpf-ifname = <i>ifname</i><br>" .
                    911:        "hostnet-tap-devpath = <i>path</i><br>" .
1.1.1.20  root      912:        "hostnet-usermode-hostfwd = <i>string</i><br>" .
                    913:        "hostnet-usermode-net = <i>string</i><br>" .
                    914:        "hostnet-usermode-net6 = <i>string</i><br>" .
1.1.1.16  root      915:        "hostnet-fallback = <i>integer</i><br>", <<<_EOM_
                    916: それぞれ <tt>hostnet0-*</tt> の別名です。
1.1.1.21  root      917: <q>These are aliases for <tt>hostnet0-*</tt> respectively.</q>
1.1.1.16  root      918: _EOM_
                    919: );
                    920: 
                    921: config_item("hostnet<i>N</i>-driver = <i>string</i>", <<<_EOM_
1.1.1.22  root      922: 起動時の <i>N</i>
1.1.1.16  root      923: 番目のイーサネットデバイスのホスト側ドライバを指定します。
1.1.1.20  root      924: <tt>afpacket</tt>、<tt>bpf</tt>、<tt>tap</tt>、<tt>usermode</tt> のうち
1.1.1.19  root      925: configure で検出したものと <tt>auto</tt>、<tt>none</tt> が選択可能です。
1.1.1.22  root      926: <q>Specifies the host driver of <i>N</i>-th ethernet device on startup.
1.1.1.20  root      927: <tt>afpacket</tt>, <tt>bpf</tt>, <tt>tap</tt> and <tt>usermode</tt> can be specified
1.1.1.19  root      928: only if the configure detects them.
                    929: <tt>auto</tt> and <tt>none</tt> can always be specified.</q>
                    930: <ul>
                    931: <li><tt>afpacket</tt> は Linux の AF_PACKET ソケットを使用します。
                    932: ホスト自身とは通信できません。
                    933: <q><tt>afpacket</tt> uses Linux's AF_PACKET socket.
                    934: It cannot communicate with the host itself.</q>
                    935: <li><tt>bpf</tt> は bpf(4) デバイスを使用します。
                    936: ホスト自身とは通信できません。
                    937: <q><tt>bpf</tt> uses bpf(4) device.
                    938: It cannot communicate with the host itself.</q>
                    939: <li><tt>tap</tt> は tap(4) デバイスを使用します。
                    940: <q><tt>tap</tt> uses tap(4) device.</q>
1.1.1.20  root      941: <li><tt>usermode</tt> は libslirp を使用したユーザモードです。
1.1.1.19  root      942: nono 自身が NAT ルータ、DHCP サーバ、DNS サーバの機能を持ちます。
                    943: <q><tt>usermode</tt> is an usermode network using libslirp.
                    944: nono also acts as NAT router, DHCP server and DNS server.</q>
                    945: <li><tt>none</tt> ならホスト側とは一切通信を行いません。
                    946: <q><tt>none</tt> doesn't make any communication with the host.</q>
                    947: </ul>
                    948: <tt>auto</tt> は <tt>usermode</tt> と同義ですが、
1.1.1.20  root      949: configure で libslirp が無効になっている場合は <tt>none</tt> と同義になります。
1.1.1.19  root      950: <tt>hostnet0-driver</tt> のデフォルトは <tt>auto</tt>、
                    951: <tt>hostnet1-driver</tt> のデフォルトは <tt>none</tt> です。
1.1.1.20  root      952: <q><tt>auto</tt> is a synonym for <tt>usermode</tt>, but
                    953: when libslirp is disabled on configure, it is a synonym for <tt>none</tt>.
1.1.1.16  root      954: The default of <tt>hostnet0-driver</tt> is <tt>auto</tt>,
1.1.1.15  root      955: the default of <tt>hostnet1-driver</tt> is <tt>none</tt>.</q>
1.1.1.21  root      956: <p>
                    957: <tt>hostnet<i>N</i></tt> と
                    958: VM 内のデバイスとの対応は下表の通り VM 種別ごとに固定です。
                    959: <q>The correspondence between <tt>hostnet<i>N</i></tt> and
                    960: device in the VM is fixed depending on the VM type as the following table.</q>
                    961: <center>
                    962: <table cellspacing=0 border=1 rules=all>
                    963: <tr><th>hostnet\VM<th>LUNA-I/LUNA-88K<th>X68030<th>NWS-1750<th>virt-m68k
                    964: <tr><th>hostnet0
                    965:  <td align=center>Lance(AM7990)
                    966:  <td align=center>Nereid#0 (RTL8019AS)
                    967:  <td align=center>Lance(AM7990)
                    968:  <td align=center>VirtIO Network
                    969: <tr><th>hostnet1
                    970:  <td align=center>N/A
                    971:  <td align=center>Nereid#1 (RTL8019AS)
                    972:  <td align=center>N/A
                    973:  <td align=center>N/A
                    974: </table>
                    975: </center>
                    976: <p>
                    977: 指定したドライバが使用出来なかった場合エラー終了します。
                    978: 起動後はメニューからドライバを変更できますが、パラメータは(まだ?)変更できません。
                    979: 実行中に変更に失敗した場合は none にフォールバックします。
                    980: <q>Terminate if the specified driver could not be used.
                    981: You can change the driver by menu at runtime,
                    982: but its parameters cannot be changed (yet?).
                    983: If changing at runtime fails, it will fallback to none.</q>
1.1.1.6   root      984: _EOM_
                    985: );
                    986: 
1.1.1.16  root      987: config_item("hostnet<i>N</i>-afpacket-ifname = <i>ifname</i>", <<<_EOM_
1.1.1.8   root      988: ホストドライバが afpacket の時にバインドするインタフェースを1つ指定します。
                    989: <i>ifname</i> が <tt>auto</tt>
                    990: なら使用可能なインタフェースを1つ自動的に選択します。
                    991: デフォルトは <tt>auto</tt> です。
                    992: なお、このホストドライバではローカルホストとの通信は出来ません。
1.1.1.14  root      993: <q>Specifies an interface name to bind to, when the host driver is afpacket.
1.1.1.8   root      994: If <tt>auto</tt> is specified as <i>ifname</i>,
                    995: it selects an usable interface automatically.
                    996: The default is <tt>auto</tt>.
                    997: Note that this host driver cannot communicate with the localhost.</q>
                    998: _EOM_
                    999: );
                   1000: 
1.1.1.16  root     1001: config_item("hostnet<i>N</i>-bpf-ifname = <i>ifname</i>", <<<_EOM_
1.1.1.8   root     1002: ホストドライバが bpf の時にバインドするインタフェースを1つ指定します。
                   1003: <i>ifname</i> が <tt>auto</tt>
                   1004: なら使用可能なインタフェースを1つ自動的に選択します。
                   1005: デフォルトは <tt>auto</tt> です。
                   1006: なお、このホストドライバではローカルホストとの通信は出来ません。
1.1.1.14  root     1007: <q>Specifies an interface name to bind to, when the host driver is bpf.
1.1.1.8   root     1008: If <tt>auto</tt> is specified as <i>ifname</i>,
                   1009: it selects an usable interface automatically.
                   1010: The default is <tt>auto</tt>.
                   1011: Note that this host driver cannot communicate with the localhost.</q>
                   1012: _EOM_
                   1013: );
                   1014: 
1.1.1.16  root     1015: config_item("hostnet<i>N</i>-tap-devpath = <i>path</i>", <<<_EOM_
1.1.1.8   root     1016: ホストドライバが tap の時に使用するデバイスを1つフルパスで指定します。
                   1017: デフォルトは <tt>auto</tt> で、この場合は自動的にデバイスを選択します。
                   1018: この時の探し方はホスト OS によって異なります。
                   1019: Linux なら <tt>/dev/net/tun</tt> を指定したのと同じです。
1.1.1.6   root     1020: OpenBSD なら <tt>/dev/tap0</tt> から <tt>/dev/tap9</tt> まで
                   1021: 順番にオープンできるまで試します。
                   1022: NetBSD (と FreeBSD) ならまず <tt>/dev/tap</tt> でクローニングを試み、
                   1023: それが失敗すれば <tt>/dev/tap0</tt> から <tt>/dev/tap9</tt> までを
                   1024: 順番にオープンできるまで試します。
1.1.1.8   root     1025: いずれの場合も VM ディレクトリかその親ディレクトリに
                   1026: <tt>nono-ifup</tt>, <tt>nono-ifdown</tt> という名前のシェルスクリプトが必要です。
                   1027: 何もすることがない場合でも正常終了する空のシェルスクリプトを用意してください。
                   1028: <q>
1.1.1.14  root     1029: Specifies a device pathname, when the host driver is tap.
1.1.1.8   root     1030: The default is <tt>auto</tt>.
1.1.1.6   root     1031: The behavior in this case depends on the host OS.
                   1032: On Linux, it's the same as <tt>/dev/net/tun</tt>.
                   1033: On OpenBSD, it will try from <tt>/dev/tap0</tt> to <tt>/dev/tap9</tt>
                   1034: until successful.
                   1035: On NetBSD (and FreeBSD), it will try cloning by <tt>/dev/tap</tt> first.
                   1036: If that fails, then try from <tt>/dev/tap0</tt> to <tt>/dev/tap9</tt>
                   1037: until successful.
1.1.1.8   root     1038: In all cases, you need to prepare two shell script files which names are
                   1039: <tt>nono-ifup</tt> and <tt>nono-ifdown</tt> in the VM directory or
                   1040: its parent directory.
                   1041: Even if you don't have anything to do in these scripts,
1.1.1.11  root     1042: you need to prepare empty scripts that will terminate successfully.</q>
1.1       root     1043: _EOM_
                   1044: );
                   1045: 
1.1.1.20  root     1046: config_item("hostnet<i>N</i>-usermode-net = <i>network</i>/<i>netmask</i>", <<<_EOM_
1.1.1.19  root     1047: ホストドライバが usermode の時の、内部 IPv4 ネットワークのアドレスを指定します。
                   1048: ネットワークアドレスは
                   1049: <tt>192.0.2.0/255.255.255.0</tt> のようにネットマスクで指定するか
                   1050: <tt>192.0.2.0/24</tt> のようにネットマスク長で指定することも出来ます。
                   1051: デフォルトは <tt>10.8.0.0/24</tt> です。
                   1052: _EOM_
                   1053: );
                   1054: 
1.1.1.20  root     1055: config_item("hostnet<i>N</i>-usermode-net6 = <i>network</i>/<i>prefixlen</i>", <<<_EOM_
1.1.1.19  root     1056: ホストドライバが usermode の時の、内部 IPv6 ネットワークのアドレスを指定します。
                   1057: ネットワークアドレスは <tt>2001:db8::/64</tt>
                   1058: のようにアドレスとプレフィックス長で指定します。
                   1059: デフォルトは <tt>fd08::/64</tt> です。
                   1060: _EOM_
                   1061: );
                   1062: 
1.1.1.20  root     1063: config_item("hostnet<i>N</i>-usermode-hostfwd = <i>entry</i>[<i>;entry</i>[<i>;…</i>]]", <<<_EOM_
1.1.1.19  root     1064: ホストドライバが usermode の時の、外部から内部へのポートフォワーディングの設定を行います。
                   1065: 1つの <i>entry</i> は
                   1066: <dl>
                   1067: <dd>
                   1068: <tt><i>protocol</i>,[<i>hostaddr</i>:]<i>hostport</i>,[<i>guestaddr</i>:]<i>guestport</i></tt>
                   1069: </dd>
                   1070: のように '<tt>,</tt>'(カンマ) 3つで区切って表します。
                   1071: <i>protocol</i> は <tt>tcp</tt> か <tt>udp</tt> です。
                   1072: <i>hostaddr</i> はホストのバインドアドレスで省略すると 0.0.0.0 です。
                   1073: <i>guestaddr</i> はゲストのアドレスで、
                   1074: 省略すると DHCP でクライアントに配布したアドレスになります
                   1075: (通常は省略します)。
                   1076: 例えば、ホストの 10022/tcp へのコネクションをゲストの 22/tcp に転送したい場合は
                   1077: <tt>tcp,10022,22</tt> となります。
                   1078: 複数指定する場合は '<tt>;</tt>'(セミコロン) で区切って1行に並べます。
                   1079: <p>
                   1080: IPv6 には対応していません。
                   1081: _EOM_
                   1082: );
                   1083: 
1.1.1.24! root     1084: config_item("hostsound-driver = <i>string</i>", <<<_EOM_
1.1.1.23  root     1085: サウンドデバイスのホスト側ドライバを指定します。
                   1086: <tt>alsa</tt>、<tt>netbsd</tt>、<tt>sndio</tt> のうち configure で検出したものと
                   1087: <tt>wav</tt>、<tt>none</tt>、<tt>auto</tt> が選択可能です。
                   1088: <q>Specifies the host sound driver.
                   1089: <tt>alsa</tt>, <tt>netbsd</tt>, and <tt>sndio</tt> are
                   1090: available only if detected by configure.
                   1091: <tt>wav</tt>, <tt>none</tt>, and <tt>auto</tt> are always selectable.</q>
1.1.1.24! root     1092: <ul>
1.1.1.23  root     1093: <li><tt>alsa</tt> は Linux の ALSA ライブラリを使用します。
                   1094:  <q><tt>alsa</tt> uses Linux's ALSA library.</q>
                   1095: <li><tt>netbsd</tt> は NetBSD の audio(4) デバイスを使用します。
                   1096:  <q><tt>netbsd</tt> uses NetBSD's audio(4) device.</q>
                   1097: <li><tt>sndio</tt> は OpenBSD の sndio ライブラリを使用します。
                   1098:  <q><tt>sndio</tt> uses OpenBSD's sndio library.</q>
                   1099: <li><tt>wav</tt> は VM ディレクトリに WAV ファイルを出力します。
                   1100: この WAV ファイルには無音のブロックは出力されません。
                   1101:  <q><tt>wav</tt> outputs WAV file in the VM directory.
                   1102:  This WAV file doesn't contains any silent blocks.</q>
                   1103: <li><tt>none</tt> はホスト側には一切出力しません。
                   1104:  <q><tt>none</tt> doesn't output anything.</q>
                   1105: <li><tt>auto</tt> なら、configure で検出された一つが選択されます。
                   1106: 検出されなければ <tt>none</tt> です。
                   1107:  <q><tt>auto</tt> selects the one detected by configure.
                   1108:  Or act as <tt>none</tt> if no drivers are detected.</q>
                   1109: </ul>
                   1110: デフォルトは <tt>auto</tt> です。
                   1111: <q>The default is <tt>auto</tt>.</q>
                   1112: _EOM_
                   1113: );
                   1114: 
1.1.1.24! root     1115: config_item("hostsound-alsa-device = <i>string</i>", <<<_EOM_
1.1.1.23  root     1116: ホストドライバが alsa の時のデバイス名を指定します。
                   1117: デフォルトは <tt>default</tt> です。
                   1118: _EOM_
                   1119: );
                   1120: 
1.1.1.24! root     1121: config_item("hostsound-netbsd-device = <i>string</i>", <<<_EOM_
1.1.1.23  root     1122: ホストドライバが netbsd の時のデバイスパスを指定します。
                   1123: デフォルトは <tt>/dev/sound</tt> です。
                   1124: _EOM_
                   1125: );
                   1126: 
1.1.1.14  root     1127: config_item("iplrom1-image = <i>path</i>", <<<_EOM_
1.1.1.13  root     1128: (X68030 Only)
                   1129: X68030 の外部 IPLROM イメージファイルのパスを指定します。
                   1130: こちらは 0xfe0000..0xffffff の 128KB の部分で、IPLROM30 と呼ばれているほうです。
                   1131: <i>path</i> がファイル名のみなら VM ディレクトリとその親ディレクトリからこのファイル名を検索します。
                   1132: <i>path</i> が相対パスなら VM ディレクトリからの相対パスになります (現在のディレクトリからではありません)。
                   1133: 空にすると無償配布されている IPLROM30 を使用します。
                   1134: デフォルトは空です。
                   1135: <q>Specifies the X68030's external IPLROM image file path.
                   1136: This one contains 128KB at 0xfe0000..0xffffff and is known as IPLROM30.
                   1137: If the <i>path</i> does not have any path delimiters,
                   1138: the VM directory and then its parent directory will be searched.
                   1139: If the <i>path</i> is a relative path,
                   1140: it will be path from the VM directory, not from the current directory.
                   1141: If the <i>path</i> is empty, the public released IPLROM30 will be used.
1.1.1.14  root     1142: The default value is empty.</q>
1.1.1.13  root     1143: _EOM_
                   1144: );
                   1145: 
1.1.1.14  root     1146: config_item("iplrom2-image = <i>path</i>", <<<_EOM_
1.1.1.13  root     1147: (X68030 Only)
                   1148: X68030 の外部 IPLROM イメージファイルのパスを指定します。
                   1149: こちらは 0xfc0000..0xfdffff の 128KB の部分で、ROM30 と呼ばれているほうです。
                   1150: <i>path</i> がファイル名のみなら VM ディレクトリとその親ディレクトリからこのファイル名を検索します。
                   1151: <i>path</i> が相対パスなら VM ディレクトリからの相対パスになります (現在のディレクトリからではありません)。
                   1152: 空にすると内蔵 ROM を使用します。
                   1153: 内蔵 ROM は NetBSD/x68k が起動する程度の SCSI IOCS のみサポートしています。
                   1154: デフォルトは空です。
                   1155: <q>Specifies the X68030's external IPLROM image file path.
                   1156: This one contains 128KB at 0xfc0000..0xfdffff and is known as ROM30.
                   1157: If the <i>path</i> does not have any path delimiters,
                   1158: the VM directory and then its parent directory will be searched.
                   1159: If the <i>path</i> is a relative path,
                   1160: it will be path from the VM directory, not from the current directory.
                   1161: If the <i>path</i> is empty, internal emulated ROM will be used.
                   1162: The ROM supports only enough SCSI IOCS to boot NetBSD/x68k.
1.1.1.14  root     1163: The default value is empty.</q>
1.1.1.13  root     1164: _EOM_
                   1165: );
                   1166: 
1.1.1.12  root     1167: config_item("keyboard-connect = <i>integer</i>", <<<_EOM_
1.1.1.14  root     1168: (LUNA and X68030 Only)
1.1.1.12  root     1169: 起動時にキーボードを本体に接続するかどうかを指定します。
                   1170: 1 なら接続し、0 なら接続しません。デフォルトは 1 です。
                   1171: 起動後はメニューから変更可能です。
1.1.1.14  root     1172: <q>Specifies whether to connect keyboard on boot.
1.1.1.12  root     1173: If 1, it is connected; if 0, it isn't connected.  The default is 1.
                   1174: You can change it on GUI menu after boot.</q>
                   1175: _EOM_
                   1176: );
                   1177: 
1.1.1.9   root     1178: config_item("luna-adjust-misused-epoch = <i>integer</i>", <<<_EOM_
1.1.1.13  root     1179: (LUNA Only)
1.1.1.9   root     1180: LUNA で誤った RTC epoch を採用している OS 向けに RTC
                   1181: エミュレーションを補正するかどうかを
                   1182: 指定します。0 なら補正をしません(実機と同じ動作)、
                   1183: 1 なら補正します(現実世界と同じ動作)。
                   1184: デフォルトは 1 で、通常 1 のままで使用して問題ありません。
                   1185: <q>
                   1186: Specifies whether nono corrects RTC emulation for OSes
                   1187: that adopts wrong RTC epoch on LUNA.
                   1188: 0 means making no correction
                   1189: (this is the same behavior as the actual machine).
                   1190: 1 means making correction
                   1191: (this is the same behavior as the real world).
                   1192: The default is 1.  Normally, leave it 1.</q>
                   1193: <p>
                   1194: LUNA で採用している RTC (MK48T02) は2桁で保持している年の値が
                   1195: 4 で割り切れる年をうるう年とする仕様です。
1.1.1.12  root     1196: ところが NetBSD/luna68k、OpenBSD/luna88k などはこの
                   1197: RTC の年の値を 1970年からの経過年として使用しています。
1.1.1.9   root     1198: 例えば1970年はうるう年ではないため 2月28日の翌日は 3月1日ですが、
                   1199: MK48T02 的には 00年であるためうるう年と認識し 2月28日の翌日が2月29日になります。
1.1.1.12  root     1200: このように、これらの OS を使っている場合実機の
                   1201: RTC は4年のうち約2年間、1日ずれた日付を指しているようです。
1.1.1.9   root     1202: しかしながら、RTC の時刻は OS 起動時に一度読んだ後は基本的に参照しない上、
                   1203: 今時必要なら NTP で時間を合わせるため、
                   1204: 実機でも問題が顕在化することはまずないと思います。
                   1205: nono の場合は実機と異なり、アプリケーション実行中しか RTC が進まないため、
                   1206: 補正がない場合の動作が問題になるのは
                   1207: nono を起動したまま偶数年の2月末日から日付をまたいで、
                   1208: かつ nono を起動したまま OS を再起動して NTP などで時刻修正を行わなかった時
                   1209: だけだと思います。
                   1210: このオプションはほぼ開発者向けの動作確認用です。
                   1211: _EOM_
                   1212: );
                   1213: 
1.1       root     1214: config_item("luna-dipsw1 = <i>string</i>", <<<_EOM_
1.1.1.13  root     1215: (LUNA Only)
1.1       root     1216: 本体前面 DIPSW#1-1..#1-8 の内容を指定します。
                   1217: "<tt>0</tt>" を DOWN、"<tt>1</tt>" を UP として、
                   1218: これを8つ並べた形式で、前から順に #1..#8 に対応します。
1.1.1.14  root     1219: <q>Specifies status of the front panel DIPSW#1-1..#1-8 using 8 digits.
1.1.1.2   root     1220: "<tt>0</tt>" means DOWN and "<tt>1</tt>" means UP.
                   1221: The first character corresponds to #1 and
1.1.1.3   root     1222: the eighth character corresponds to #8.</q>
                   1223: <p>
                   1224: LUNA-I でのデフォルトは <tt>11110111</tt> です。
                   1225: 各スイッチの内容は以下のリンクを参照してください。
                   1226: <q>On LUNA-I, the default value is <tt>11110111</tt>.
1.1.1.4   root     1227: See the following link about DIPSW.</q><br>
1.1.1.3   root     1228: → <a href="https://wiki.netbsd.org/ports/luna68k/luna68k_info/"
                   1229: >NetBSD/luna68k: Information</a>
1.1       root     1230: <br>
1.1.1.12  root     1231: LUNA-88K でのデフォルトは <tt>11111111</tt> です。
1.1.1.4   root     1232: 各スイッチの内容は以下のリンクを参照してください。
1.1.1.12  root     1233: <q>On LUNA-88K, the default value is <tt>11111111</tt>.
1.1.1.4   root     1234: See the following link about DIPSW.</q><br>
                   1235: → <a href="http://man.openbsd.org/boot_luna88k.8"
                   1236: >OpenBSD manual pages: boot_luna88k(8)</a>
1.1.1.14  root     1237: <p>
                   1238: 自動起動するかどうかとシリアルコンソールを使うかどうかを指定したい場合は
                   1239: こちらではなく
                   1240: <a href="#config-dipsw-autoboot">dipsw-autoboot、dipsw-serial</a>
                   1241: 設定を使うほうが便利です。
                   1242: <q>If you only want to specify whether to autoboot and/or
                   1243: to use serial console,
                   1244: <a href="#config-dipsw-autoboot">dipsw-autoboot, dipsw-serial</a>
                   1245: configurations are useful.</q>
1.1       root     1246: _EOM_
                   1247: );
                   1248: 
                   1249: config_item("luna-dipsw2 = <i>string</i>", <<<_EOM_
1.1.1.13  root     1250: (LUNA Only)
1.1       root     1251: 本体前面 DIPSW#2-1..#2-8 の内容を指定します。
                   1252: 書式は <tt>luna-dipsw1</tt> と同じです。
                   1253: デフォルトは <tt>11111111</tt> です。
1.1.1.2   root     1254: <q>Specifies status of the front panel DIPSW#2-1..#2-8.
                   1255: The same syntax as <tt>luna-dipsw1</tt> is used.
                   1256: The default value is <tt>11111111</tt>.</q>
1.1.1.3   root     1257: <p>
1.1.1.4   root     1258: NetBSD/luna68k のブートローダは、
                   1259: DIPSW#2 が "<tt>11111111</tt>" なら自動的にカーネルをロードして実行し、
                   1260: どれかでも "<tt>0</tt>" にするとプロンプトで停止するようです。
1.1       root     1261: <span class=strike>(本当は #8 だけで制御するつもりだったんじゃないかという気がします)</span>
1.1.1.4   root     1262: <q>NetBSD/luna68k bootloader will automatically load and execute the kernel,
                   1263: if the DIPSW#2 is "<tt>11111111</tt>".
1.1.1.2   root     1264: Otherwise, the bootloader will enter interactive mode.
                   1265: <span class=strike>(I doubt that they actually wanted to switch with only #8)
1.1.1.11  root     1266: </span></q>
1.1       root     1267: _EOM_
                   1268: );
                   1269: 
1.1.1.12  root     1270: config_item("luna-video-plane = <i>integer</i>", <<<_EOM_
1.1.1.13  root     1271: (LUNA Only)
1.1.1.14  root     1272: LUNA のビデオボードのプレーン数を 1、4、8 から指定します。
1.1.1.12  root     1273: 1 ならモノクロビデオボード、
1.1.1.14  root     1274: 4 なら16色 (4bpp) ビデオボード、
                   1275: 8 なら 256色 (8bpp) ビデオボードです。
1.1.1.15  root     1276: デフォルトは 4 です。
1.1.1.14  root     1277: <q>Specifies number of planes on LUNA video board.
                   1278: The valid values are 1, 4 or 8.
1.1.1.12  root     1279: 1 means a monochrome video board,
1.1.1.14  root     1280: 4 means 16-color (4bpp) video board,
                   1281: 8 means 256-color (8bpp) video board.
1.1.1.15  root     1282: The default value is 4.</q>
1.1.1.14  root     1283: _EOM_
                   1284: );
                   1285: 
1.1.1.17  root     1286: config_item(
                   1287:        "m88100-version = <i>integer</i><br>" .
                   1288:        "m88200-version = <i>integer</i>", <<<_EOM_
                   1289: (LUNA-88K Only)
                   1290: MPU と CMMU のマスクバージョンを設定します。
                   1291: 今の所これによるエミュレータの動作の違いはありません。
                   1292: どちらかというとこれを参照しているゲスト OS の動作確認用です。
                   1293: デフォルトは <tt>m88100-version</tt> が 11、<tt>m88200-version</tt> が 9 です。
                   1294: <q>Specifies MPU and CMMU mask version.
                   1295: This item doesn't affect any MPU/CMMU emulations for now.
                   1296: But it may be useful for verifying the guest OS behaviors.
                   1297: The default value is 11 for <tt>m88100-version</tt>,
                   1298: 9 for <tt>m88200-version</tt>.</q>
                   1299: _EOM_
                   1300: );
                   1301: 
1.1.1.15  root     1302: config_item("mainview-scale = <i>double</i>", <<<_EOM_
1.1.1.14  root     1303: メインウィンドウの起動時のスケールを実数で指定します。
                   1304: コマンドラインオプション <tt>-s</tt> で上書き可能です。
                   1305: 起動後はメニューから、
                   1306: プリセットされた倍率とここで指定した倍率には変更可能です。
1.1.1.15  root     1307: デフォルトは 1.0 です。
1.1.1.14  root     1308: _EOM_
                   1309: );
                   1310: 
1.1.1.15  root     1311: config_item("monitor-fontsize = <i>integer</i>",
1.1.1.14  root     1312: <<<_EOM_
                   1313: テキスト系モニタとステータスパネルのフォントサイズを
                   1314: 12, 16, 24 から指定します。
                   1315: コマンドラインオプション <tt>--fontsize</tt> で上書き可能です。
                   1316: 起動後はメニューから変更することができます。
                   1317: デフォルトは 12 です。
1.1.1.12  root     1318: _EOM_
                   1319: );
                   1320: 
1.1.1.3   root     1321: config_item("monitor-rate = <i>integer</i>", <<<_EOM_
                   1322: テキスト系モニタウィンドウの更新頻度を Hz 単位で指定します。
                   1323: 1 から 60 までの間で指定でき、デフォルトは 20Hz です。
1.1.1.15  root     1324: 起動後にメニューから、
                   1325: プリセットされた頻度とここで指定した頻度には変更可能です。
1.1.1.3   root     1326: <q>Specifies refresh rate of all text monitor windows in Hz.
                   1327: It ranges from 1 to 60.  The default is 20Hz.
1.1.1.14  root     1328: You can choose this value on GUI menu after boot,
1.1.1.15  root     1329: from preset rate or rate specified here.</q>
1.1.1.3   root     1330: _EOM_
                   1331: );
                   1332: 
1.1       root     1333: config_item("mpu-clock = <i>value</i>", <<<_EOM_
                   1334: MPU のクロック数を MHz 単位で指定します。
1.1.1.14  root     1335: デフォルトは LUNA-I なら 20MHz、LUNA-88K と X68030 なら 25MHz です。
1.1.1.17  root     1336: virt-m68k ではあまり意味はありませんが 25MHz です。
1.1.1.5   root     1337: <q>Specifies the MPU clock in MHz.
1.1.1.16  root     1338: The default value is 20MHz on LUNA-I, or 25MHz on LUNA-88K and X68030.
1.1.1.17  root     1339: On virt-m68k, it's less meaningful but 25MHz.</q>
1.1       root     1340: _EOM_
                   1341: );
                   1342: 
1.1.1.24! root     1343: config_item("<span class=new>mpu-force-disable-dcahce = <i>integer</i><br>" .
        !          1344:        "mpu-force-disable-icache = <i>integer</i></span>", <<<_EOM_
        !          1345: <span class="new">
        !          1346: MPU のデータキャッシュ(dcache)/命令キャッシュ(icache)
        !          1347: を強制的に無効にすることが出来ます。
        !          1348: <tt>0</tt> ならキャッシュを常に無効にします。<tt>1</tt> なら通常動作です。
        !          1349: デフォルトは <tt>1</tt> です。
        !          1350: MPU が 68030 の場合 CACR の EI, ED に 1 を書き込んでも 0 のままになるという意味です。
        !          1351: m88k は未対応です。
        !          1352: <q>You can forcibly disable MPU data cache (dcache)/instruction cache (icache).
        !          1353: <tt>0</tt> means forcibly disable the cache.
        !          1354: <tt>1</tt> means normal operation.
        !          1355: The default is <tt>1</tt>.
        !          1356: On 68030, forcibly disable means that even if
        !          1357: you write 1 to EI, ED on CACR, it will remain 0.
        !          1358: Not supported for m88k.</q>
        !          1359: </span>
        !          1360: _EOM_
        !          1361: );
        !          1362: 
1.1.1.19  root     1363: config_item("mpu-type = <i>value</i>", <<<_EOM_
1.1.1.18  root     1364: (X68030, virt-m68k Only)
1.1.1.20  root     1365: MPU 種別を <tt>68030</tt> か <tt>68040</tt> で指定します。
                   1366: デフォルトは <tt>68030</tt> です。
1.1.1.18  root     1367: <q>Specifies the MPU type, <tt>68030</tt> or <tt>68040</tt>.
                   1368: The default is <tt>68030</tt>.</q>
                   1369: _EOM_
                   1370: );
                   1371: 
1.1.1.8   root     1372: config_item("mpu-pseudo-stop = <i>integer</i>", <<<_EOM_
1.1.1.13  root     1373: (LUNA-88K Only)
1.1.1.8   root     1374: m88100 にて疑似 STOP 状態を有効にするかどうかを指定します。
                   1375: 0 なら無効(実機と同じ動作)、1 なら有効で、デフォルトは 1 です。
                   1376: m88100 には、m68k の STOP 命令 (割り込みが上がるまで何もせず待つ)
                   1377: に相当する命令がなく、
                   1378: 大抵ビジーウェイトループで割り込みが上がるのを待つことになります。
                   1379: これは実機では (消費電力を減らす手段がないという些細な問題以外には)
                   1380: 何のデメリットもないのですが、
                   1381: エミュレータで特に高速動作させている時には割り込みが上がるまで
                   1382: (例えば人間がキーを入力するまで) ホスト CPU パワーを使い潰してビジーウェイトループを実行し続けることになり、ホスト CPU があっつあつになります。
                   1383: それを防ぐための機能です。
                   1384: 特徴的な命令列を検出して実現しているので、すべての状況で動作するわけではありません。
                   1385: _EOM_
                   1386: );
                   1387: 
1.1.1.16  root     1388: config_item(
1.1.1.15  root     1389:        "nereid0-enable = <i>integer</i><br>" .
1.1.1.16  root     1390:        "nereid1-enable = <i>integer</i><br>", <<<_EOM_
1.1.1.15  root     1391: (X68030 Only)
                   1392: Nereid 拡張ボードを装着するかどうかを指定します。
                   1393: Nereid は同時に2枚まで使用することができます。
                   1394: 値は <tt>0</tt> なら装着せず、<tt>1</tt> なら装着します。
                   1395: デフォルトは <tt>0</tt> (装着しない) です。
1.1.1.24! root     1396: 詳細は <a href="#nereid">Nereid エミュレーション</a> の項を参照してください。
1.1.1.15  root     1397: <q>Specifies whether install Nereid expansion board or not.
                   1398: Up to two board can be operated at the same time.
1.1.1.24! root     1399: If set to <tt>0</tt>, the board is not installed.
        !          1400: If set to <tt>1</tt>, the board is installed.
1.1.1.15  root     1401: The default value is <tt>0</tt>.
1.1.1.24! root     1402: See also <a href="#nereid">Nereid emulation</a> section below for details.</q>
1.1.1.15  root     1403: _EOM_
                   1404: );
                   1405: 
1.1.1.16  root     1406: config_item(
1.1.1.15  root     1407:        "nereid0-net = <i>integer</i><br>" .
1.1.1.16  root     1408:        "nereid1-net = <i>integer</i><br>", <<<_EOM_
1.1.1.15  root     1409: (X68030 Only)
                   1410: Nereid ボードの NIC (RTL8019AS) のみを無効にすることが出来ます
                   1411: (実機では通常そのようなことは出来ません)。
                   1412: <tt>0</tt> なら無効、<tt>1</tt> なら有効です。デフォルトは <tt>1</tt> です。
                   1413: 通常は <tt>1</tt> のまま使用してください。
                   1414: この設定は対応する <tt>nereid<i>N</i>-enable</tt> が <tt>0</tt>
                   1415: (ボードを装着しない) の場合は意味を持ちません。
                   1416: <q>This can disable only NIC (RTL8019AS) of Nereid expansion board
                   1417: (although it's not possible normally in the real world).
                   1418: It's disabled if <tt>0</tt>, or enabled if <tt>1</tt>.
                   1419: The default is <tt>1</tt>.  Normally, leave it <tt>1</tt>.
                   1420: This item will be ignored if the corresponding <tt>nereid<i>N</i>-enable</tt>
                   1421: is <tt>0</tt>.</q>
                   1422: _EOM_
                   1423: );
                   1424: 
1.1.1.16  root     1425: config_item(
1.1.1.15  root     1426:        "nereid0-ram-size = <i>integer</i><br>" .
1.1.1.16  root     1427:        "nereid1-ram-size = <i>integer</i><br>", <<<_EOM_
1.1.1.15  root     1428: (X68030 Only)
                   1429: Nereid ボードのバンクメモリのサイズを MB 単位で指定します。
                   1430: 指定できるのは <tt>0</tt>, <tt>4</tt>, <tt>16</tt> です。
                   1431: <tt>0</tt> を指定するとバンクメモリを無効にします。
                   1432: デフォルトは <tt>16</tt> です。
                   1433: この設定は対応する <tt>nereid<i>N</i>-enable</tt> が <tt>0</tt>
                   1434: (ボードを装着しない) の場合は意味を持ちません。
                   1435: <q>Specifies bank memory size in MB of Nereid expansion board.
                   1436: The valid values are <tt>0</tt>, <tt>4</tt> or <tt>16</tt>.
1.1.1.24! root     1437: If set to <tt>0</tt>, disable the bank memory.
1.1.1.15  root     1438: The default is <tt>16</tt>.
                   1439: This item will be ignored if the corresponding <tt>nereid<i>N</i>-enable</tt>
                   1440: is <tt>0</tt>.</q>
                   1441: <br><br>
                   1442: また通常は必要ありませんが -4 または -16 を指定すると、
                   1443: バンクメモリは無効にした上で Nereid 制御ポートのビット6の読み出し値
                   1444: (バンクメモリの容量) を再現することが出来ます。
                   1445: -4 ならビット6は 0 (4MB)、0 か -16 なら 1(16MB) が読み出せます。
                   1446: _EOM_
                   1447: );
                   1448: 
1.1.1.14  root     1449: config_item("news-dipsw = <i>string</i>", <<<_EOM_
                   1450: (NEWS Only)
                   1451: DIPSW の内容を指定します。
                   1452: "<tt>0</tt>" を OFF、"<tt>1</tt>" を ON として、
                   1453: これを8つ並べた形式で、前から順に SW1..SW8 に対応します。
                   1454: デフォルトは <tt>00001000</tt> です。
                   1455: <q>Specifies status of the DIPSW using 8 digits.
                   1456: "<tt>0</tt>" means OFF and "<tt>1</tt>" is ON.
                   1457: The first character corresponds to SW1 and
                   1458: the eighth character corresponds to SW8.
                   1459: The default valus is <tt>00001000</tt>.</q>
                   1460: <br><br>
                   1461: 各スイッチの内容は以下のリンクを参照してください。
                   1462: <q>See the following link about DIPSW.</q><br>
                   1463: → <a href="https://www.netbsd.org/ports/news68k/faq.html#dip_sw"
                   1464: >NetBSD/news68k Frequently Asked Questions</a>
                   1465: <p>
                   1466: 自動起動するかどうかとシリアルコンソールを使うかどうかを指定したい場合は
                   1467: こちらではなく
                   1468: <a href="#config-dipsw-autoboot">dipsw-autoboot、dipsw-serial</a>
                   1469: 設定を使うほうが便利です。
                   1470: <q>If you only want to specify whether to autoboot and/or
                   1471: to use serial console,
                   1472: <a href="#config-dipsw-autoboot">dipsw-autoboot, dipsw-serial</a>
                   1473: configurations are useful.</q>
                   1474: _EOM_
                   1475: );
                   1476: 
1.1.1.2   root     1477: config_item("prom-image = <i>path</i>", <<<_EOM_
1.1.1.13  root     1478: (LUNA Only)
1.1.1.12  root     1479: LUNA-I/LUNA-88K の外部 ROM イメージファイルのパスを指定します。
1.1.1.2   root     1480: <i>path</i> がファイル名のみなら VM ディレクトリとその親ディレクトリからこのファイル名を検索します。
                   1481: <i>path</i> が相対パスなら VM ディレクトリからの相対パスになります (現在のディレクトリからではありません)。
                   1482: 空にすると内蔵 ROM を使用します。
                   1483: デフォルトは空です。
1.1.1.12  root     1484: <q>Specifies the LUNA-I/LUNA-88K's external ROM image file path.
1.1.1.2   root     1485: If the <i>path</i> does not have any path delimiters,
                   1486: the VM directory and then its parent directory will be searched.
                   1487: If the <i>path</i> is a relative path,
1.1.1.13  root     1488: it will be path from the VM directory, not from the current directory.
1.1.1.2   root     1489: If the <i>path</i> is empty, internal emulated ROM will be used.
                   1490: The default value is empty.</q>
1.1       root     1491: <p>
1.1.1.2   root     1492: 実機を持っていない場合はこの値を空に (= デフォルトのままに) しておくと、
1.1.1.8   root     1493: nono 内蔵のなんちゃって下位互換 ROM で起動します。
1.1.1.2   root     1494: <q>If you does not have the real LUNA machines,
                   1495: you can boot with nono's internal downward compatible emulated ROM
1.1.1.11  root     1496: if you set this field empty (or leave it as the default).</q>
1.1       root     1497: <p>
1.1.1.4   root     1498: LUNA-I 実機を持っている場合は
                   1499: ROM ファイルを指定することで実機 ROM で起動できます。
1.1.1.2   root     1500: ROM ファイルは実機の 0x41000000-0x4101ffff (128KB) を保存したものです。
1.1.1.3   root     1501: 今のところ ROM は V4.22 (Thu Jul 27 11:45:42 1989) のみサポートしています。
                   1502: それ以外については何も分かりません。
1.1.1.4   root     1503: <q>If you have the real LUNA-I machine,
1.1.1.2   root     1504: you can boot with the real ROM spcifying the ROM file path.
1.1.1.4   root     1505: The ROM file is extracted from 0x41000000-0x4101ffff (128KB) of
                   1506: the real LUNA-I machine.
1.1.1.3   root     1507: For now, only V4.22 (Thu Jul 27 11:45:42 1989) is supported.
1.1.1.11  root     1508: I have no idea about other ROMs.</q>
1.1.1.4   root     1509: <p>
1.1.1.12  root     1510: LUNA-88K 実機の場合は 0x41000000-0x4103ffff (256KB) を保存したものです。
1.1.1.8   root     1511: 今のところ ROM は version 1.20 のみサポートしています。
1.1.1.4   root     1512: <q>
1.1.1.12  root     1513: For LUNA-88K,
1.1.1.4   root     1514: the ROM file is extracted from 0x41000000-0x4103ffff (256KB).
1.1.1.11  root     1515: For now, only version 1.20 is supported.</q>
1.1.1.2   root     1516: _EOM_
                   1517: );
                   1518: 
1.1.1.3   root     1519: config_item("ram-size = <i>integer</i>", <<<_EOM_
1.1.1.13  root     1520: 搭載する RAM サイズを MB 単位で指定します。<q>Specifies the RAM size in MB.</q>
                   1521: <ul>
                   1522: <li>LUNA-I のデフォルトは 16MB です。
1.1.1.6   root     1523: 16MB 未満は 4MB 単位で、
1.1.1.16  root     1524: 16MB 以上は 512MB まで 1MB 単位で指定できます。
                   1525: ただし <tt>prom-image</tt> で実機イメージを指定した場合は 255MB が上限になります。
                   1526: ちなみに NetBSD/luna68k の起動には最低でも 8MB 必要です。
1.1.1.13  root     1527: <q>On LUNA-I, the default is 16MB.
1.1.1.6   root     1528: If the size is less than 16MB, you can specify in 4MB unit.
1.1.1.16  root     1529: If larger, you can specify up to 512MB in 1MB unit.
                   1530: However, if you have <tt>prom-image</tt> with the real image,
                   1531: the maximum is limited to 255MB.
1.1.1.13  root     1532: By the way, NetBSD/luna68k needs at least 8MB to boot.</q>
                   1533: <li>LUNA-88K のデフォルトは 64MB です。
                   1534: 64MB 未満は 16MB 単位で、
1.1.1.16  root     1535: 64MB 以上は暫定で 512MB まで 1MB 単位で指定できます。
                   1536: ただし <tt>prom-image</tt> で実機イメージを指定した場合は
                   1537: 240MB が上限になります。
1.1.1.13  root     1538: <q>On LUNA-88K, the default is 64MB.
1.1.1.6   root     1539: If the size is less than 64MB, you can specify in 16MB unit.
1.1.1.16  root     1540: If larger, you can specify up to tentative 512MB in 1MB unit.
                   1541: However, if you have <tt>prom-image</tt> with the real image,
1.1.1.20  root     1542: the maximum is limited to 240MB.</q>
1.1.1.14  root     1543: <li>X68030 ではメイン RAM 容量を示し、デフォルトは 12MB です。
1.1.1.13  root     1544: 4MB から 12MB まで 1MB 単位で指定できます。
1.1.1.15  root     1545: 拡張メモリについては extram-size を参照してください。
1.1.1.14  root     1546: <q>On X68030, the default is 12MB.
                   1547: You can specify it in 1MB unit from 4MB to 12MB.
1.1.1.15  root     1548: See extram-size for extended memory.</q>
1.1.1.14  root     1549: <li>NWS-1750 では現状 16MB で変更できません。
                   1550: <q>On NWS-1750, This is 16MB fixed for now.</q>
1.1.1.17  root     1551: <li>virt-m68k のデフォルトは 128MB です。
1.1.1.20  root     1552: 16MB から 4080MB まで指定可能です。
1.1.1.16  root     1553: 指定された値が 16MB で割り切れない場合は 16MB 単位に切り上げになります。
1.1.1.17  root     1554: <q>On virt-m68k, the default is 128MB and
1.1.1.16  root     1555: the range is 16MB to 4080MB.
                   1556: If the specified size is not divisible by 16MB,
1.1.1.17  root     1557: it will be rounded up to 16MB.</q>
1.1.1.13  root     1558: </ul>
1.1       root     1559: _EOM_
                   1560: );
                   1561: 
1.1.1.12  root     1562: config_item("rtc-epoch-year = <i>integer</i>", <<<_EOM_
1.1.1.13  root     1563: (LUNA Only)
                   1564: RTC (MK48T02) の基準年を指定します。
1.1.1.12  root     1565: デフォルトは 1970年です。
                   1566: NetBSD/luna68k、OpenBSD/luna88k はいずれも基準年を 1970年としていますので、
                   1567: デフォルトのままで構いません。
                   1568: ゲスト OS に 4.4BSD を使用する際は 1900 を指定します。
1.1.1.14  root     1569: NEWS では今の所 1900 固定で変更出来ません。
1.1.1.13  root     1570: <q>Specifies the RTC (MK48T02) epoch year.
1.1.1.12  root     1571: The default is 1970.
                   1572: Since both NetBSD/luna68k and OpenBSD/luna88k use 1970 as epoch year,
                   1573: there is no need to touch this value.
1.1.1.14  root     1574: If you boot 4.4BSD on LUNA-I as the guest OS, specify 1900.
                   1575: On NEWS, it is fixed at 1900.</q>
1.1.1.12  root     1576: _EOM_
                   1577: );
                   1578: 
1.1.1.7   root     1579: config_item("show-statuspanel = <i>integer</i>", <<<_EOM_
                   1580: ステータスパネルを表示するかどうかを指定します。
                   1581: 0 なら非表示、1 なら表示です。
1.1.1.14  root     1582: デフォルトは 1(表示) です。
1.1.1.7   root     1583: 起動後はメニューから変更可能です。
                   1584: <q>Specifies whether to display the status panel or not.
                   1585: If 0, it is hidden; if 1, it is shown.
1.1.1.14  root     1586: The default is 1 (show).
1.1.1.11  root     1587: You can change it on GUI menu after boot.</q>
1.1.1.7   root     1588: _EOM_
                   1589: );
                   1590: 
1.1.1.9   root     1591: config_item("spc0-id<i>N</i>-image = <i>devtype</i>[,<i>path</i>]", <<<_EOM_
1.1.1.14  root     1592: (LUNA and X68030 Only)
1.1.1.24! root     1593: SCSI デバイス種別と<a href="#diskimage">ディスクイメージ</a>を指定します。
        !          1594: キーの <i>N</i> には 0 から 7 が入ります。
1.1.1.9   root     1595: ただし ID 7 は本体が使用しますので指定しないでください。
                   1596: 値はデバイス種別 <i>devtype</i> とディスクイメージパス <i>path</i>
                   1597: を "<tt>,</tt>"(カンマ) で区切って並べた形式です。
                   1598: デバイス種別 <i>devtype</i> は以下のいずれかです。
1.1.1.20  root     1599: <q>Specifies SCSI device and image.  <i>N</i> in the key is 0 to 7.
1.1.1.2   root     1600: But don't specify ID 7 because the host uses it.
                   1601: The value is in a form of device type <i>devtype</i> and
1.1.1.9   root     1602: the disk image path <i>path</i> separated by "<tt>,</tt>"(comma).
1.1.1.11  root     1603: <i>devtype</i> can be one of the following:</q>
1.1.1.9   root     1604: <ul>
                   1605: <li><tt>hd</tt> … HD drive
                   1606: <li><tt>cd</tt> … CD-ROM drive
                   1607: <li><tt>mo</tt> … MO drive
                   1608: </ul>
                   1609: 
                   1610: <p>
                   1611: <i>devtype</i> が <tt>hd</tt> なら <i>path</i> は省略できません。
                   1612: <i>devtype</i> が <tt>cd</tt> か <tt>mo</tt> なら <i>path</i> は省略可能です。
                   1613: イメージパスが相対パスなら VM ディレクトリからの相対パスになります。
1.1.1.20  root     1614: <q>If <i>devtype</i> is <tt>hd</tt>, <i>path</i> cannot be ommitted.
1.1.1.9   root     1615: If <i>devtype</i> is <tt>cd</tt> or <tt>mo</tt>, <i>path</i> can be ommitted.
1.1.1.11  root     1616: If the <i>path</i> is relative path, it is from the VM directory.</q>
1.1.1.2   root     1617: 
1.1       root     1618: <p>
1.1.1.24! root     1619: 例えば、nono.cfg と同じディレクトリに置いた sd0.qcow2 を
1.1.1.9   root     1620: 起動 HDD ディスクイメージとして使い
                   1621: (LUNA では通常 ID 6 をプライマリ HDD に割り当てます)、
                   1622: ID 5 に同じディレクトリの install.iso をセットした CD ドライブを、
                   1623: ID 4 に起動時メディアなしの MO ドライブを接続する場合は次のようになります。
1.1.1.24! root     1624: <q>For example, if you use a harddisk image sd0.qcow2 placed in the same
1.1.1.9   root     1625: directory as nono.cfg
                   1626: (LUNA usually assigns ID 6 to the primary HDD),
                   1627: ID 5 for CD-ROM drive that loads install.iso in the same directory,
                   1628: and ID 4 for MO drive without media on boot,
1.1.1.2   root     1629: write as following:</q>
1.1       root     1630: <blockquote><pre>
1.1.1.24! root     1631: spc0-id6-image = hd,sd0.qcow2
1.1.1.9   root     1632: spc0-id5-image = cd,install.iso
                   1633: spc0-id4-image = mo
1.1       root     1634: </pre></blockquote>
                   1635: _EOM_
                   1636: );
                   1637: 
1.1.1.4   root     1638: config_item("spc0-id<i>N</i>-seektime = <i>integer</i>", <<<_EOM_
1.1.1.14  root     1639: (LUNA and X68030 Only)
1.1.1.4   root     1640: 指定の SCSI HDD の平均シークタイムを msec 単位で指定します。
                   1641: 現在のデフォルトは <tt>0</tt> です (S・S・D!! S・S・D!!)。
                   1642: 16 程度を指定すると幾分往時に思いを馳せることが出来るかもしれませんが、
                   1643: 今の所あまり安定していません。
                   1644: <q>Specifies the average seek time of specified SCSI HDD in msec.
                   1645: Currently, the default value is <tt>0</tt>
                   1646: (This may be something like SSD :-).
                   1647: If you specify about 16 or so, you can feel nostalgic,
1.1.1.11  root     1648: but this feature is still unstable.</q>
1.1.1.4   root     1649: _EOM_
                   1650: );
                   1651: 
1.1.1.9   root     1652: config_item("spc0-id<i>N</i>-writeignore = <i>integer</i>", <<<_EOM_
1.1.1.14  root     1653: (LUNA and X68030 Only)
                   1654: 指定の SCSI HD デバイスへの書き込みをイメージに書き戻すかどうか指定します。
1.1       root     1655: <tt>0</tt> なら通常動作(書き込みを行う)です。
1.1.1.14  root     1656: <tt>1</tt> ならディスクイメージに一切書き戻しません。
                   1657: デバイスへ書き込んだはずのデータは Copy-On-Write の要領で、
                   1658: VM ディレクトリ内の一時ファイルに書き込みます。
                   1659: この一時ファイルはアプリケーション終了時に削除します。
1.1       root     1660: fsck を気にせずカーネルのデバッグとかを行いたい場合にはどうぞ。
                   1661: 何が起きるか意味が分からない人は指定しないでください。
                   1662: デフォルトは <tt>0</tt> です。
1.1.1.14  root     1663: <q>Specifies whether nono writes a writing to SCSI HD devices back
                   1664: to the diskimage.
                   1665: <tt>0</tt> means normal operation (writes to the diskimage).
                   1666: <tt>1</tt> means that nono will not write to the diskimage back.
                   1667: Data that the guest wrote to the device will be written to a temporary file
                   1668: in the VM directory,
                   1669: like Copy-On-Write.
                   1670: The temporary file will be removed when the application exits.
1.1.1.2   root     1671: This is useful for kernel debugging because it does not require fsck
1.1.1.14  root     1672: after the kernel hangs or reboots.
                   1673: Don't use this flag if you don't understand this paragraph.
1.1.1.9   root     1674: The default value is <tt>0</tt>.</q>
                   1675: <p>
                   1676: ちなみに、メディアを書き込み禁止にしたい場合はこれではなく、
                   1677: イメージファイルの書き込み権を落としてください。
                   1678: <q>By the way, if you want to make the media write-protected,
                   1679: clear the write permission from the image file
                   1680: (instead of this setting).</q>
                   1681: _EOM_
                   1682: );
                   1683: 
1.1.1.14  root     1684: config_item("sram-sync-ramsize = <i>integer</i>", <<<_EOM_
1.1.1.13  root     1685: (X68030 Only)
                   1686: SRAM の RAM 容量欄を実際の RAM サイズに合わせるかどうかを指定します。
                   1687: <tt>0</tt> なら何もしません (実機と同じ)。
                   1688: <tt>1</tt> なら、アプリケーション起動時に
                   1689: SRAM の \$ed0008.L (RAM 容量) を ram-size の設定値で更新します。
                   1690: この更新は、
                   1691: アプリケーション起動時に SRAM マジックが正しく書かれている場合のみ行われます。
                   1692: デフォルトは <tt>1</tt> です。
1.1.1.14  root     1693: <q>Specifies whether to synchronize a RAM size field in SRAM
1.1.1.13  root     1694: with real RAM size or not.
1.1.1.24! root     1695: If set to <tt>0</tt>, the application will do nothing (as same as the real).
        !          1696: If set to <tt>1</tt>, the application updates(synchronizes)
1.1.1.13  root     1697: \$ed0008.L (RAM size) in SRAM with configuration value of ram-size.
                   1698: This update is performed once only if
                   1699: the SRAM magic string is correct at the application startup.
                   1700: The default is <tt>1</tt>.</q>
                   1701: _EOM_
                   1702: );
1.1.1.14  root     1703: 
1.1.1.17  root     1704: config_item("virtio-block<i>N</i>-image = <i>path</i>", <<<_EOM_
1.1.1.20  root     1705: (virt-m68k Only)
1.1.1.24! root     1706: VirtIO ブロックデバイスの<a href="#diskimage">ディスクイメージ</a>を指定します。
1.1.1.20  root     1707: キーの <i>N</i> は現状 0 から 7 が指定可能です。
1.1.1.16  root     1708: イメージパスが相対パスなら VM ディレクトリからの相対パスになります。
1.1.1.20  root     1709: <q>Specifies VirtIO block device's image.
                   1710: <i>N</i> in the key is 0 through 7 for now.
1.1.1.16  root     1711: If the path is relative path, it is from the VM directory.</q>
                   1712: _EOM_
                   1713: );
                   1714: 
1.1.1.17  root     1715: config_item("virtio-block<i>N</i>-writeignore = <i>integer</i>", <<<_EOM_
1.1.1.20  root     1716: (virt-m68k Only)
                   1717: 指定の VirtIO ブロックデバイスへの書き込みをイメージに書き戻すかどうか指定します。
                   1718: 詳細は <tt>spc0-id<i>N</i>-writeignore</tt> を参照してください。
                   1719: <q>Specifies whether nono writes a writing to VirtIO block devices back
1.1.1.16  root     1720: to the diskimage.
1.1.1.20  root     1721: See <tt>spc0-id<i>N</i>-writeignore</tt> for details.</q>
                   1722: _EOM_
                   1723: );
                   1724: 
1.1.1.24! root     1725: config_item("<span class=new>virtio-entropy = <i>integer</i></span>", <<<_EOM_
        !          1726: <span class="new">
        !          1727: VirtIO エントロピーデバイスを無効にすることが出来ます。
        !          1728: <tt>0</tt> なら無効、<tt>1</tt> なら有効です。デフォルトは <tt>1</tt> です。
        !          1729: <q>You can disable VirtIO entropy device.
        !          1730: <tt>0</tt> means disabled, <tt>1</tt> means enabled.
        !          1731: The default is <tt>1</tt>.</q>
        !          1732: </span>
        !          1733: _EOM_
        !          1734: );
        !          1735: 
        !          1736: config_item("<span class=new>virtio-net = <i>integer</i></span>", <<<_EOM_
        !          1737: <span class="new">
        !          1738: VirtIO ネットワークデバイスを無効にすることが出来ます。
        !          1739: <tt>0</tt> なら無効、<tt>1</tt> なら有効です。デフォルトは <tt>1</tt> です。
        !          1740: <q>You can disable VirtIO network device.
        !          1741: <tt>0</tt> means disabled, <tt>1</tt> means enabled.
        !          1742: The default is <tt>1</tt>.</q>
        !          1743: </span>
        !          1744: _EOM_
        !          1745: );
        !          1746: 
        !          1747: config_item("<span class=new>virtio-scsi = <i>integer</i></span>", <<<_EOM_
        !          1748: <span class="new">
        !          1749: VirtIO SCSI デバイスを無効にすることが出来ます。
        !          1750: <tt>0</tt> なら無効、<tt>1</tt> なら有効です。デフォルトは <tt>1</tt> です。
        !          1751: <q>You can disable VirtIO SCSI device.
        !          1752: <tt>0</tt> means disabled, <tt>1</tt> means enabled.
        !          1753: The default is <tt>1</tt>.</q>
        !          1754: </span>
        !          1755: _EOM_
        !          1756: );
        !          1757: 
1.1.1.21  root     1758: config_item("virtio-scsi-id<i>N</i>-image = <i>devtype</i>[,<i>path</i>]", <<<_EOM_
1.1.1.20  root     1759: (virt-m68k Only)
1.1.1.24! root     1760: VirtIO SCSI デバイス種別と<a href="#diskimage">ディスクイメージ</a>を指定します。
1.1.1.20  root     1761: イニシエータ ID が不要なため、
                   1762: キーの <i>N</i> には 0 から 7 が指定できます。
                   1763: 詳細は <tt>spc0-id<i>N</i>-image</tt> を参照してください。
                   1764: <q>Specifies VirtIO SCSI device and image.
                   1765: You can specify all of 0 thorugh 7 for the key <i>N</i>,
                   1766: because there is no initiator.
                   1767: See <tt>spc0-id<i>N</i>-image</tt> for more details.</q>
                   1768: _EOM_
                   1769: );
                   1770: 
1.1.1.21  root     1771: config_item("virtio-scsi-id<i>N</i>-writeignore = <i>integer</i>", <<<_EOM_
1.1.1.20  root     1772: (virt-m68k Only)
                   1773: 指定の VirtIO SCSI デバイスへの書き込みをイメージに書き戻すかどうか指定します。
                   1774: 詳細は <tt>spc0-id<i>N</i>-writeignore</tt> を参照してください。
                   1775: <q>Specifies whether nono writes a writing to VirtIO SCSI devices back
                   1776: to the diskimage.
                   1777: See <tt>spc0-id<i>N</i>-writeignore</tt> for details.</q>
1.1.1.16  root     1778: _EOM_
                   1779: );
                   1780: 
                   1781: config_item("windrv-path = <i>path</i>", <<<_EOM_
                   1782: (X68030 Only)
                   1783: Windrv でゲスト側に見せるホストディレクトリを指定します。
                   1784: 今の所指定できるディレクトリは1つだけです。
                   1785: 空なら Windrv デバイスが存在しないように振る舞います。
                   1786: デフォルトは空です。
                   1787: _EOM_
                   1788: );
                   1789: 
                   1790: config_item("x68k-cut-fc2 = <i>integer</i>", <<<_EOM_
                   1791: (X68030 Only)
                   1792: MPU (68030) の FC2 ピンを切断するかどうかを指定します。
                   1793: <tt>0</tt> なら切断しません (標準の状態)。
                   1794: <tt>1</tt> なら切断します。
                   1795: デフォルトは <tt>1</tt> です。
                   1796: NetBSD/x68k で X サーバを起動する場合のみ <tt>1</tt> にする必要があります。
                   1797: <q>Specifies whether to cut MPU(68030) FC2 pin.
1.1.1.24! root     1798: If set to <tt>0</tt>, no modification is applied
        !          1799: (the original FC2 pin is kept).
        !          1800: If set to <tt>1</tt>, the FC2 pin is cut.
1.1.1.16  root     1801: The default is <tt>1</tt>.
                   1802: Only if you run the X server on NetBSD/x68k, it needs to be <tt>1</tt>.</q>
1.1.1.14  root     1803: _EOM_
                   1804: );
                   1805: 
1.1.1.19  root     1806: config_item("xp-clock = <i>value</i>", <<<_EOM_
1.1.1.18  root     1807: (LUNA Only)
                   1808: XP プロセッサのクロック数を MHz 単位で指定します。
                   1809: デフォルトは 6.144 [MHz] です。
1.1.1.24! root     1810: <q>Specifies the XP processor's clock in MHz.
        !          1811: The default value is 6.144 MHz.</q>
1.1.1.18  root     1812: _EOM_
                   1813: );
                   1814: 
1.1.1.16  root     1815: 
1.1       root     1816: ?>
                   1817: </dl>
                   1818: </div>
1.1.1.14  root     1819: <?php H4end(); ?>
1.1       root     1820: 
                   1821: 
1.1.1.14  root     1822: <?php H4("aboutvm", "VM について <q>About VM</q>"); ?>
1.1.1.13  root     1823: 
1.1.1.14  root     1824: <?php H5("", "実装状況 <q>Implementation Status</q>"); ?>
1.1.1.13  root     1825: <div class="main">
                   1826: <table cellpadding=0 cellspacing=0>
                   1827: <tr><td style="padding-right: 1em">◎ <td>: ほぼ実装済み <q>Mostly implemented</q>
                   1828: <tr><td>○    <td>: 困らない程度には実装済み <q>Works</q>
                   1829: <tr><td>△    <td>: とりあえず動いてる程度 <q>Works somehow</q>
                   1830: <tr><td>×     <td>: 未実装 <q>Not implemented</q>
                   1831: <tr><td>—    <td>: 実装予定なし <q>Not planned</q>
                   1832: </table>
                   1833: <style type="text/css">
                   1834: .pghd {
                   1835:        border: 0px none;
                   1836:        border-bottom: 1px solid black;
                   1837:        padding-top: 1em;
                   1838: }
                   1839: .pgth {
                   1840:        border-top: 0px none;
                   1841:        border-left: 1px solid black;
                   1842:        border-right: 1px solid black;
                   1843:        border-bottom: 1px solid black;
                   1844:        padding-right: 1ex;
                   1845: }
                   1846: .pgtd {
                   1847:        border-top: 0px none;
                   1848:        border-left: 0px none;
                   1849:        border-right: 1px solid black;
                   1850:        border-bottom: 1px solid black;
                   1851: }
                   1852: </style>
                   1853: <table cellspacing=0 cellpadding=0>
                   1854: <?php
                   1855:        $table = <<<__EOM__
                   1856: LUNA-I
1.1.1.18  root     1857: MPU (68030)            ◎
1.1.1.13  root     1858: FPU (68881)            ◎
                   1859: BT454                  ◎
                   1860: CRTC2                  ○     標準で使用する値のみサポート
                   1861: Frame buffer   ◎
                   1862: Keyboard/Mouse ◎
1.1.1.14  root     1863: SIO (uPD7201)  ◎
                   1864: PIO (8255)             ○
1.1.1.16  root     1865: Ethernet (AM7990)      ◎
1.1.1.13  root     1866: NVRAM&amp;RTC (MK48T02)        ◎
                   1867: Front LCD              ◎
1.1.1.14  root     1868: SPC (MB89352)  ◎
1.1.1.13  root     1869: SCSI HD/CD/MO Devices  ○
1.1.1.15  root     1870: XP(HD647180) CPU       △
                   1871: XP(HD647180) Timer0/1  ○
1.1.1.22  root     1872: XP(HD647180) ASCI      ○
1.1.1.15  root     1873: XP(HD647180) その他の内蔵デバイス<br><q>Other internal devices</q>   ×
                   1874: XP 周辺デバイス <q>Peripheral devices</q>        ×
1.1.1.13  root     1875: 電源 <q>Power Circuit</q>                    ○
                   1876: 
                   1877: LUNA-88K specific
                   1878: MPU (88100 part)       ○     マルチプロセッサ未実装、バグも未実装? <wbr><q>MP (and bugs?) not implemented</q>
                   1879: MPU (88200 part)       ◎
                   1880: MPU (88110)            —     実装予定なし <q>Not planned</q>
                   1881: FUSEROM                        ○
                   1882: 
                   1883: X68030
1.1.1.18  root     1884: MPU (68030)            ◎     68EC030 は実装予定なし <q>68EC030 is not planned</q>
1.1.1.13  root     1885: FPU (68881)            ◎     68882 は未実装 <q>68882 not implemented</q>
1.1.1.19  root     1886: MPU (68040)            △     キャッシュ未実装、実行サイクル未考察
1.1.1.16  root     1887: DMAC                   △
1.1.1.22  root     1888: CRTC/VC                        △     768x512 画面モードのみサポート <wbr><q>Only 768x512 screen mode is supported</q>
1.1.1.13  root     1889: FDC/FDD                        ○
1.1.1.16  root     1890: 標準・拡張エリアセット <q>Areaset</q>       ◎
1.1.1.24! root     1891: ADPCM                  ○     フィルタ未実装、録音は実装予定なし <q>Filter is not implemented. Recording is not planned</q>
1.1.1.23  root     1892: OPM                    ×
1.1.1.16  root     1893: テキスト画面<q>Text screen</q>   ○
                   1894: コントラスト <wbr><q>Contrast</q>        ◎
1.1.1.23  root     1895: グラフィック機能全般 <wbr><q>All other graphics</q>  △     グラフィック画面(1024x1024 モード)、<wbr>画面間プライオリティ(合成を除く)、<wbr>個別画面オンオフのみ実装。これ以外は当面予定なし。
1.1.1.13  root     1896: Keyboard               ◎     TVコントロールを除く <q>Except TV Control</q>
                   1897: Mouse                  ◎     本体接続のみ
                   1898: MFP                            △
1.1.1.14  root     1899: PPI (8255)             △
1.1.1.13  root     1900: Printer                        ×
                   1901: RTC                            ◎     アラームを除く <q>Except Alarm</q>
1.1.1.14  root     1902: SPC (MB89352)  ◎
1.1.1.13  root     1903: SCSI HD/CD/MO Devices  ○
1.1.1.14  root     1904: SCC (Z8530)            ◎
1.1.1.13  root     1905: SRAM                   ◎
                   1906: システムポート<q>System port</q>        △
                   1907: 電源 <q>Power curcuit</q>                    ○
1.1.1.16  root     1908: Nereid Ethernet                ◎
                   1909: Nereid Bank memory     ◎
1.1.1.13  root     1910: Nereid USB                     —     実装予定なし <q>Not planned</q>
1.1.1.15  root     1911: 拡張メモリ <q>Extended memory</q> ○
1.1.1.16  root     1912: Windrv                 △
1.1.1.14  root     1913: 
                   1914: NWS-1750
1.1.1.18  root     1915: MPU (68030)            ◎
1.1.1.14  root     1916: FPU (68881)            ◎     68882 は未実装 <q>68882 not implemented</q>
                   1917: PROM                           ×
                   1918: SCC (Z8530)            ◎     チャンネル A のみホストに接続 <wbr><q>Only channel A is connected to the host</q>
1.1.1.16  root     1919: Ethernet (AM7990)      ◎
1.1.1.14  root     1920: NVRAM&amp;RTC (MK48T02)        ◎
                   1921: Video Board            ×
                   1922: Keyboard/Mouse ×
                   1923: SCSI Controller                ×
                   1924: IDROM, DIP-SW, 100Hz Timer, 診断用LED               ○
                   1925: AST, Lv2Intr   ×
                   1926: 電源 <q>Power Circuit</q>    ×
                   1927: 
1.1.1.17  root     1928: virt-m68k
1.1.1.18  root     1929: MPU (68030)            ◎
1.1.1.16  root     1930: FPU (68881)            ◎     68882 は未実装 <q>68882 not implemented</q>
1.1.1.19  root     1931: MPU (68040)            △     キャッシュ未実装、実行サイクル未考察
1.1.1.17  root     1932: Goldfish PIC   ◎
                   1933: Goldfish RTC   ◎
                   1934: Goldfish Timer ◎
                   1935: Goldfish TTY   ○
1.1.1.20  root     1936: VirtIO Block   ○
                   1937: VirtIO Network         ○
                   1938: VirtIO Entropy ◎
1.1.1.21  root     1939: VirtIO SCSI            ○
1.1.1.17  root     1940: Power Control  ○
1.1.1.16  root     1941: 
1.1.1.13  root     1942: __EOM__;
                   1943:        $table_lines = preg_split("/\n/", $table);
                   1944:        foreach ($table_lines as $line) {
                   1945:                if ($line == "") {
                   1946:                        continue;
1.1.1.16  root     1947:                } else if (preg_match("/\t/", $line) == 0) {
1.1.1.13  root     1948:                        // table title
1.1.1.16  root     1949:                        print "<tr><td colspan=3 class=pghd>{$line}\n";
1.1.1.13  root     1950:                } else {
1.1.1.16  root     1951:                        $t = preg_split("/\t+/", $line, 3);
                   1952:                        $h = isset($t[0]) ? $t[0] : "";
                   1953:                        $m = isset($t[1]) ? $t[1] : "";
                   1954:                        $d = isset($t[2]) ? $t[2] : "";
1.1.1.13  root     1955:                        print "<tr><td class=pgth>{$h}\n";
                   1956:                        print " <td class=pgtd style='padding: 0 1ex 0 1ex'>{$m}\n";
                   1957:                        print " <td class=pgtd style='padding-left: 0.5ex'>{$d}\n";
                   1958:                }
                   1959:        }
                   1960: ?>
                   1961: </table>
                   1962: </div>
1.1.1.14  root     1963: <?php H5end(); ?>
1.1.1.13  root     1964: 
1.1.1.14  root     1965: <?php H5("", "MPU (68030)"); ?>
                   1966: <div class="main">
1.1.1.24! root     1967: MMU、キャッシュあたりはほぼ実装していると思います。
        !          1968: 命令の実行サイクルについてはある程度似せているつもりですが、
        !          1969: 68000 のようにサイクル数を正確に数えるのは困難です。
1.1.1.13  root     1970: </div>
1.1.1.14  root     1971: <?php H5end(); ?>
1.1.1.13  root     1972: 
1.1.1.19  root     1973: <?php H5("", "MPU (68040)"); ?>
                   1974: <div class="main">
1.1.1.18  root     1975: いくつか未実装の命令があります。
                   1976: キャッシュは未実装で、
                   1977: それに伴いキャッシュ制御を行う新設命令 CINV*, CPUSH* も未実装です。
1.1.1.19  root     1978: MMU、ATC はまだ怪しいです。
1.1.1.18  root     1979: FPU はある程度動作すると思いますが
                   1980: 例外を起こす細かい条件は未検証のため、
                   1981: 本来は例外が起きてソフトウェア (FPSP) で処理するはずのものが
                   1982: 68881 相当のハードウェアエミュレーションで実行出来てしまうという
                   1983: 通常あまり困らないタイプの問題は存分にあります。
                   1984: <br>
1.1.1.20  root     1985: 命令の実行サイクルについてはある程度似せているつもりですが、
1.1.1.18  root     1986: そもそも 68040 はパイプライン方式なので 68000 時代のようにサイクル数を
1.1.1.21  root     1987: 正確にエミュレーションすることはおそらく不可能です。
1.1.1.18  root     1988: <br>
1.1.1.20  root     1989: 68040 は X68030 と virt-m68k でのみ選択可能です。
1.1.1.18  root     1990: NEWS に 68040 搭載モデルはなさそうなのと、
                   1991: LUNA では 68040 搭載モデルは LUNA-I ではなく LUNA-II になるからです。
1.1.1.19  root     1992: </div>
1.1.1.18  root     1993: <?php H5end(); ?>
                   1994: 
1.1.1.14  root     1995: <?php H5("", "LUNA の ROM エミュレーション"); ?>
                   1996: <div class="main">
1.1.1.13  root     1997: LUNA-I、LUNA-88K で PROM の外部イメージを指定しない場合
                   1998: (<tt>prom-image</tt> が空の場合)、
                   1999: 内蔵の独自 ROM が動作し、コンソールモニタが起動します。
                   2000: このコンソールモニタの動作は実機のそれとよく似ていますが、
                   2001: これは実機確認の際に操作方法が違いすぎると(自分が)困るため仕方なく似せているもので、
                   2002: 忠実なコピーを作る目的ではありません。
                   2003: </div>
1.1.1.14  root     2004: <?php H5end(); ?>
1.1.1.13  root     2005: 
1.1.1.14  root     2006: <?php H5("", "X68030 の ROM (ROM30) エミュレーション"); ?>
                   2007: <div class="main">
1.1.1.13  root     2008: X68030 で ROM30 の外部イメージを指定しない場合
                   2009: (<tt>iplrom2-image</tt> が空の場合)、内蔵の独自 ROM が組み込まれます。
                   2010: 本来の ROM30 には SCSIIOCS の他に ROM デバッガなどが含まれていますが、
                   2011: 内蔵 ROM はこのうち SCSIIOCS を NetBSD/x68k が起動するのに十分なだけしか
                   2012: 実装していません。
                   2013: Human68k を起動する場合はお手元の実機から ROM イメージを作成してください。
                   2014: </div>
1.1.1.14  root     2015: <?php H5end(); ?>
                   2016: 
1.1.1.22  root     2017: <?php H5("", "X68030 のグラフィック画面"); ?>
                   2018: <div class="main">
                   2019: X68030 のグラフィック画面を一部実装しています。
                   2020: これにより NetBSD/x68k の標準設定の X サーバは起動します。
                   2021: グラフィック画面として実装しているのは 1024x1024 (16色) モードのみです。
                   2022: ビデオコントローラは、画面間プライオリティと画面オンオフを実装しており、
                   2023: テキスト画面とグラフィック画面の優先度を変更することは出来ます。
                   2024: ただし合成や半透明合成は未実装ですので実質切り替えられるだけです。
                   2025: スクロール等 CRTC の機能も未実装です。
                   2026: </div>
                   2027: <?php H5end(); ?>
                   2028: 
1.1.1.16  root     2029: <?php H5("", "NEWS エミュレーション"); ?>
                   2030: <div class="main">
                   2031: NEWS エミュレーションは今の所
                   2032: <tt>-X</tt> オプションでカーネルを直接起動することしか出来ません。
                   2033: PROM も NetBSD/news68k
                   2034: の起動と終了に最低限必要な程度が誤魔化してあるだけです。
                   2035: また、デバイスの配置や、デバイスが存在しないアドレスへのアクセスが
                   2036: どうなるかなどは実機確認をしていないため分かりません。
                   2037: 従って、動くものは動く、程度のものでしかありません。
                   2038: というかネタです。
                   2039: </div>
                   2040: <?php H5end(); ?>
                   2041: 
1.1.1.17  root     2042: <?php H5("", "virt-m68k エミュレーション"); ?>
1.1.1.16  root     2043: <div class="main">
                   2044: QEMU の "virt" (架空ハードウェア仕様)の互換機wをサポートしています。
                   2045: NetBSD/virt68k が動作します。
                   2046: <tt>-X</tt> オプション (または設定の <tt>exec-file</tt>)
1.1.1.18  root     2047: でカーネルを、
1.1.1.19  root     2048: 設定の <tt>exec-bootparam</tt> でルートデバイスを
                   2049: それぞれ指定してください。
1.1.1.16  root     2050: インストール時には <tt>--initrd</tt> (または設定の <tt>exec-initrd</tt>)
                   2051: で RAM ディスクイメージも指定します。
                   2052: <q>Supports QEMU "virt" virtual hardware's compatible machine and
                   2053: it can run NetBSD/virt68k.
                   2054: You need to specify the kernel by <tt>-X</tt> option
                   2055: (or <tt>exec-file</tt> in configuration).
                   2056: If you want to install, you also need to specify the ramdisk image by
1.1.1.18  root     2057: <tt>--initrd</tt> option (or <tt>exec-initrd</tt> in configuration).</q>
                   2058: </div>
                   2059: <?php H5end(); ?>
                   2060: 
1.1.1.24! root     2061: <?php H5("", "シリアルコンソールの端末エミュレーション"); ?>
1.1.1.18  root     2062: <div class="main">
                   2063: virt-m68k (や NEWS) のようにシリアルコンソールしか持たない機種のために、
                   2064: メイン画面でシリアルコンソールの端末エミュレーションを実装してあります。
1.1.1.24! root     2065: <tt>hostcom-driver = console</tt> とすることで nono のメイン画面に
1.1.1.18  root     2066: シリアルコンソールの内容が表示されます。
1.1.1.24! root     2067: <span class="new">
        !          2068: 概ね VT220 互換です。
        !          2069: ただし倍角文字、背景色切り替え、タブ設定等サポートしてないものもあります。
        !          2070: VT220 互換のためカラーはサポートしていません。
        !          2071: 132 桁モードをサポートしました。
        !          2072: ブリンクをサポートしました。
        !          2073: VT220 にはないイタリックはサポートしています。
        !          2074: </span>
1.1.1.18  root     2075: バックログはありませんので、バックログが必要なら
                   2076: <tt>stdio</tt> 等を使ってください。
1.1.1.16  root     2077: </div>
                   2078: <?php H5end(); ?>
                   2079: 
1.1.1.24! root     2080: <?php H5("diskimage", "<span class=new>ディスクイメージ <q>Disk image</q></span>"); ?>
        !          2081: <div class="main">
        !          2082: <span class="new">
        !          2083: HD, CD, MO, FD 等のディスクイメージは QCOW2 形式と生イメージをサポート
        !          2084: しています。
        !          2085: QCOW2 形式かどうかはヘッダのマジックで自動判別しますが、
        !          2086: 判別できないものはすべて生イメージとして扱います。
        !          2087: <q>QCOW2 and raw format are supported for the disk images for
        !          2088: HD, CD, MO and FDs.</q>
        !          2089: </span>
        !          2090: <p>
        !          2091: <span class="new">
        !          2092: QCOW2 形式のうち、外部バッキングファイル (CoW) を持つもの、
        !          2093: zstd 圧縮されたもの、
        !          2094: 暗号化されているもの
        !          2095: は未対応です。
        !          2096: また refcount が 16 ビットでないものも未対応ですが通常遭遇しないはず。
        !          2097: イメージがスナップショットを持っている場合、
        !          2098: スナップショットに関与せず最新の状態だけを読み書きします。
        !          2099: イメージが zlib 圧縮されているものについては読み込み専用でのみ対応しています。
        !          2100: 書き込みは技術的には可能ですが仕組みを考えると嬉しくないので対応しません。
        !          2101: </span>
        !          2102: </div>
        !          2103: <?php H5end(); ?>
        !          2104: 
1.1.1.21  root     2105: <?php H5("", "usermode ネットワーク"); ?>
                   2106: <div class="main">
                   2107: usermode ネットワークでは nono 自身が
                   2108: NAT ルータ、DHCP サーバ、DNS サーバの機能を持ちます。
                   2109: ルータと DHCP サーバのアドレスはネットワークアドレス +1 (デフォルトでは 10.8.0.1)、
                   2110: DNS サーバのアドレスはネットワークアドレス +2 (デフォルトでは 10.8.0.2) です。
                   2111: IPv6 ルータのアドレスはネットワークアドレス +1 (デフォルトでは fd08::1)、
                   2112: DNS サーバのアドレスはネットワークアドレス +2 (デフォルトでは fd08::2) です。
                   2113: </div>
                   2114: <?php H5end(); ?>
                   2115: 
1.1.1.24! root     2116: <?php H5("nereid", "X68030 の Nereid エミュレーション <q>Nereid emulation on X68030</q>"); ?>
1.1.1.16  root     2117: <div class="main">
1.1.1.15  root     2118: 現実の Nereid はイーサネット/メモリ/USB の複合拡張ボードで、
                   2119: このうちメモリは、メインメモリの増設に使える他、
                   2120: メインメモリとして使わなかった領域をバンクメモリとして使うことも出来ます。
                   2121: nono ではこの Nereid の機能のうちイーサネット (RTL8019AS)
                   2122: とバンクメモリのみサポートします。
                   2123: メインメモリの増設機能はエミュレータでは意味がないので実装しません。また
                   2124: USB (SL811HS/T) の実装予定はありません。
                   2125: <q>Nereid in the real world is a combined Ethernet/memory/USB expansion board.
                   2126: Of these, the memory can be used to expand main memory,
                   2127: and areas not used for the main memory can be used as bank memory.
                   2128: nono supports only ethernet (RTL8019AS) and bank memory among
                   2129: the functions of the Nereid expansion board.
                   2130: Main memory expansion is not supported because it's meaningless on emulators.
                   2131: Also, USB (SL811HS/T) is not planned for implementation.</q>
                   2132: <br><br>
                   2133: Nereid は DIPSW6,7 によりアドレス・割り込みベクタの組を2通り指定できるため、
                   2134: 2枚まで同時に運用することが出来ます。
                   2135: 本来 SW6 と SW7 は (衝突さえしなければ) 任意に組み合わせることが可能ですが、
                   2136: nono では簡便のためボード #0 は SW6,7 が OFF、
                   2137: ボード #1 は SW6,7 が ON と固定しています。
                   2138: <q>Since Nereid can set to two different combinations of addresses and
                   2139: interrupt vectors by DIPSW,
                   2140: so up to two boards can be operated at the same time.
                   2141: Originally, SW6 and SW7 can be arbitrarily combined
                   2142: (as long as they don't collide), in nono however, for simpility,
                   2143: SW6 and SW7 are fixed to be OFF on board #0, and
                   2144: SW6 and SW7 are fixed to be ON on board #1.</q>
                   2145: <blockquote>
1.1.1.16  root     2146: <table border=1 rules=all>
1.1.1.15  root     2147: <tr><th><th>#0 (<tt>nereid0-*</tt>)<th>#1 (<tt>nereid1-*</tt>)
                   2148: <tr><td align=center>ベースアドレス・割り込みベクタ<br><q>Base address and interrupt vectors</q>
                   2149:  <td>$ece300,$f9,$fb<br>(SW7=OFF)
                   2150:  <td>$eceb00,$f8,$fa<br>(SW7=ON)
                   2151: <tr><td align=center>バンクメモリウィンドウ<br><q>Bank memory window</q>
                   2152:  <td>$ee0000<br>(SW6=OFF)
                   2153:  <td>$ef0000<br>(SW6=ON)
                   2154: </table>
                   2155: </blockquote>
                   2156: バンクメモリは、メインメモリとして使わなかった領域を使用します。
                   2157: そのため実機でもバンクメモリの容量は DIPSW のメインメモリ割り当て設定
                   2158: (SW1-5) に依存します。
                   2159: nono に関係する結論だけでいうと、
                   2160: メインメモリへの割り当てを一切行わない場合はバンクメモリは 16MB 確保でき、
                   2161: メインメモリへの割り当てをいくらかでも行うとバンクメモリは 4MB となります。
                   2162: 設定の <tt>nereid<i>N</i>-ram-size</tt> はこの部分を指定していることになります。
                   2163: またこの容量とは独立に SW8 でバンクメモリの有効・無効を指定できますので、
                   2164: <tt>nereid<i>N</i>-ram-size</tt> が 0 (以下) というのは SW8
                   2165: でバンクメモリを無効にしたことに相当します。
                   2166: <q>Bank memory uses memory areas not used as the main memory.
                   2167: So the bank memory size depends on the main memory settings (SW1-5).
                   2168: As a result,
                   2169: only if you don't allocate any memories to main memory,
                   2170: the bank memory can be allocated 16MB.
                   2171: Otherwise, the bank memory will be allocated 4MB.
                   2172: Thus, <tt>nereid<i>N</i>-ram-size</tt> specifies this value.
                   2173: Also, SW8 specifies enable/disable of the bank memory regardless of the size,
                   2174: <tt>nereid<i>N</i>-ram-size = 0</tt> (or less) means disabling the bank memory.</q>
1.1.1.16  root     2175: </div>
1.1.1.15  root     2176: <?php H5end(); ?>
                   2177: 
1.1.1.20  root     2178: <?php H5("netbsd-x68k-timesync", "NetBSD/x68k での時間同期"
                   2179:  . "<q>Time Synchronization on NetBSD/x68k</q>"); ?>
                   2180: <div class="main">
                   2181: X68030 でゲスト OS に NetBSD/x68k を使う場合、
                   2182: nono と NetBSD/x68k を次の通りに設定すれば
                   2183: nono をフルスピード動作にしてもゲスト OS の時間がずれなくなります。
                   2184: まず nono の設定ファイルに以下を追加します。
                   2185: <blockquote><pre class=file>
                   2186: clock-sync = real
                   2187: </pre></blockquote>
                   2188: ゲストの NetBSD/x68k を起動し、
                   2189: <tt>/etc/sysctl.conf</tt> に以下の1行を追加します。
                   2190: <blockquote><pre class=file>
                   2191: kern.timecounter.hardware=clockinterrupt
                   2192: </pre></blockquote>
                   2193: さらに <tt>/etc/rc.conf</tt> に
                   2194: <blockquote><pre class=file>
                   2195: ntpdate=YES
                   2196: ntpdate_hosts=ntp.nict.jp
                   2197: </pre></blockquote>
                   2198: などと設定します (NTP サーバはお好みで)。
                   2199: sysctl の設定によって、ゲスト OS の時計は「この設定が有効になった時点から」
                   2200: 実時間間隔を刻めますが、
                   2201: 電源オンからここまでにずれた分が解決できるわけではありませんので、
                   2202: 必然的に時計を合わせる必要もあるためです。
                   2203: これで再起動すると次回からはフルスピードでも実時間を刻めます。
                   2204: (再起動せずに有効にしたい場合はこの設定の後 root ユーザで
                   2205: <blockquote><pre class=cons>
                   2206: /etc/rc.d/sysctl start
                   2207: /etc/rc.d/ntpdate start
                   2208: </pre></blockquote>
                   2209: を実行してください)
1.1.1.19  root     2210: </div>
                   2211: <?php H5end(); ?>
                   2212: 
1.1.1.16  root     2213: <?php H5("", "Windrv"); ?>
1.1.1.14  root     2214: <div class="main">
1.1.1.17  root     2215: X68030 で Windrv を一応サポートしています。
1.1.1.16  root     2216: Human68k からホストのファイルシステムをアクセスする機構です。
1.1.1.17  root     2217: 従来の Windrv とはホスト OS の前提が異なるため、
                   2218: 既存実装からの移植ではありませんし、
1.1.1.16  root     2219: そもそも Human68k とホスト(UNIX)ファイルシステムの差異による制約も多くあります。
                   2220: これらを把握してから使用してください。
                   2221: <ul>
                   2222: <li>ファイル名は21文字すべて認識します。
                   2223: 22文字以上(というか 18.3 形式以外)のファイル名はゲストからは見えません。
                   2224: <li>ファイル名中の ASCII 以外の文字には現状対応していません。
                   2225: これらの文字を含むファイルはゲストからは見えません。
                   2226: <li>マルチピリオドには対応していません。
                   2227: このようなファイルはゲストからは見えません。
                   2228: <li>大文字小文字は区別しません。
                   2229: 大文字小文字だけが違う同名のファイル (例えば a.BAK と a.bak) があると、
                   2230: 検索(FILES/NFILES) には現れません。
                   2231: この状況で a.Bak (大文字小文字を区別していれば違うファイル)
1.1.1.19  root     2232: を新規作成しようとすると (大文字小文字を区別しないゲスト OS からは
                   2233: a.Bak というエントリは存在しないように見えるにも関わらず)
                   2234: 作成できなくしてあります。
1.1.1.16  root     2235: <li>ファイルサイズが 2GB 以上のファイルはゲストからは見えません。
                   2236: <li>Human68k 側の属性は A(アーカイブ)/D(ディレクトリ)/R(読み込み専用)
                   2237: のみ対応しています。
                   2238: S(システム)/H(隠しファイル)属性は保存されません。
                   2239: <li>ホストのシンボリックリンクは、リンク先の
                   2240: ファイルもしくはディレクトリとして見えます。
                   2241: またリンク先が Windrv のルートパスの外側を指していても構いません。
                   2242: <li>ファイルのロックには対応していません。
                   2243: <li>WindrvXM.sys による拡張動作には対応していません。
                   2244: windrv 互換として動作します。
                   2245: <li>TwentyOne.x は現状 +T/-C/-P/-S (いずれもデフォルト) 相当だと思います。
                   2246: TwentyOne.x が常駐していないとか、
                   2247: これ以外のオプションの時にどうなるかは把握していません。
                   2248: <li>lndrv.x によるゲスト側のシンボリックリンク機能には未対応です。
                   2249: </ul>
                   2250: <p></p>
                   2251: Windrv を使用する場合、まず nono
                   2252: の設定ファイルに <tt>windrv-path</tt> を設定します。
                   2253: 次にゲストの Human68k の CONFIG.SYS に WINDRV.SYS (または WindrvXM.sys)
                   2254: を設定してください。
                   2255: <blockquote>
                   2256: <pre class=file>
                   2257: DEVICE = \SYS\WINDRV.SYS
                   2258: </pre>
                   2259: </blockquote>
1.1.1.14  root     2260: </div>
                   2261: <?php H5end(); ?>
1.1.1.13  root     2262: 
1.1.1.14  root     2263: <?php H5("", "ステータスパネル <q>Status Panel</q>"); ?>
1.1.1.7   root     2264: <div class="main">
                   2265: ステータスパネル中央にあるパフォーマンスメータのアイコンは
                   2266: 高速モードの状態を表示しています。
                   2267: ダブルクリックすると高速/等速モードの指定を切り替えることができます。
                   2268: <q>The performance meter's icon at the center of the status panel
                   2269: shows the VM speed status.
1.1.1.11  root     2270: You can switch full speed / syncronized mode by double-clicking
                   2271: on this icon.</q>
1.1.1.7   root     2272: <table>
                   2273: <tr><td valign=top>
                   2274: <image src="image/sp-ffmark0.png" style="padding:0.5ex; background-color:white">
                   2275: <td valign=top>…
                   2276: <td valign=top>
                   2277: マークなしの場合、ユーザが等速モードを指定していて、等速モードで実行中です。
                   2278: <q>When no icons are displayed,
                   2279: the user has specified syncronized mode and
                   2280: the VM is running in synchronized mode.</q>
                   2281: <tr><td valign=top>
1.1.1.11  root     2282: <image src="image/sp-ffmark2.png" style="padding:0.5ex; background-color:white">
1.1.1.7   root     2283: <td valign=top>…
                   2284: <td valign=top>
1.1.1.11  root     2285: 三角3つの場合、ユーザが高速モードを指定していて、高速モードで実行中です。
1.1.1.8   root     2286: 高速モード中はパーセントではなく何倍速で動作しているかを表します。
1.1.1.11  root     2287: <q>When an icon (three triangles) is displayed,
1.1.1.7   root     2288: the user has specified full speed mode and
1.1.1.11  root     2289: the VM is running in full speed mode.
1.1.1.7   root     2290: <tr><td valign=top>
1.1.1.11  root     2291: <image src="image/sp-ffmark1.png" style="padding:0.5ex; background-color:white">
1.1.1.7   root     2292: <td valign=top>…
                   2293: <td valign=top>
1.1.1.11  root     2294: 三角2つの場合、ユーザが高速モードを指定していて、等速モードで実行中です。
                   2295: 以下のいずれかの状態で起きます。
                   2296: <q>When an icon (two triangles) is displayed,
1.1.1.7   root     2297: the user has specified full speed mode and
1.1.1.11  root     2298: the VM is running in synchronized mode.
                   2299: This will happen when any of the following occurs:</q>
                   2300: <ul>
1.1.1.23  root     2301: <li>キー押下中(後述)あるいはキーボードブザー発声中
                   2302: <q>When any keys are pressed (see below),
1.1.1.11  root     2303: or the keyboard buzzer is sounding.
                   2304: <li>STOP instruction on m68k.
                   2305: <li>pseudo STOP state on m88k.
                   2306: </ul>
1.1.1.7   root     2307: </table>
                   2308: </div>
1.1.1.14  root     2309: <?php H5end(); ?>
1.1.1.7   root     2310: 
1.1.1.14  root     2311: <?php H5("", "DIPSW 設定ウィンドウ"); ?>
                   2312: <div class="main">
                   2313: DIPSW 設定ウィンドウでの変更はアプリケーション起動中のみ有効です。
                   2314: またここでの設定は即 VM に反映されますが、
                   2315: LUNA の場合 DIPSW の状態を
                   2316: PIO(8255) がラッチするのが概ね起動時および再起動時のみとなっています
                   2317: (厳密には PROM と XP が云々ですが)。
                   2318: </div>
1.1.1.16  root     2319: <?php H5end(); ?>
1.1.1.14  root     2320: 
                   2321: <?php H5("", "メモリダンプモニタ <q>Memory Dump Monitor</q>"); ?>
                   2322: <div class="main">
                   2323: メモリダンプモニタの出力形式を、バイト、ワード、ロングワード
                   2324: (m88k ではそれぞれバイト、ハーフワード、ワードと表現します)
                   2325: から選択できます。
                   2326: また 68030/88200 の MMU ディスクリプタとして表示させることもできます
                   2327: (この位置が正しいディスクリプタかどうかは関係なく表示します)。
1.1.1.16  root     2328: 逆アセンブルは、
                   2329: LUNA-I なら m68k と HD64180 の逆アセンブルが、
                   2330: LUNA-88K なら m88k と HD64180 の逆アセンブルが、
1.1.1.17  root     2331: X68030/virt-m68k/NEWS なら m68k の逆アセンブルが選択できます。
1.1.1.14  root     2332: <q>On memory dump monitor,
1.1.1.23  root     2333: you can select the output format from byte, word and longword
1.1.1.14  root     2334: (In m88k, it is represented as byte, halfword and word respectively).
1.1.1.23  root     2335: Also you can select 68030/88200 MMU descriptor format
1.1.1.14  root     2336: (It displays regardless of whether this address is used as descriptor or not).
1.1.1.15  root     2337: Disassemble is now merged from disassemble monitor.
1.1.1.23  root     2338: On LUNA-I, you can select m68k and HD64180 disassemble.
                   2339: On LUNA-88K, you can select m88k and HD64180 disassemble.
1.1.1.17  root     2340: On X68030/virt-m68k/NEWS,
1.1.1.23  root     2341: you can select m68k disassemble.</q>
1.1.1.14  root     2342: <p>
                   2343: 表示されているダンプ値をダブルクリックすることでメモリの値を編集できます。
                   2344: 編集できるのはメモリと以下の部分のみです。
                   2345: <q>You can edit the memory value by double click.
1.1.1.15  root     2346: Only memory and the following areas are editable.</q>
1.1.1.14  root     2347: <ul>
                   2348: <li>NVRAM (LUNA and NEWS Only) …
                   2349: 編集するとただちにファイルも更新します。
1.1.1.16  root     2350: 後ろの8バイトのみ時計レジスタを兼ねているため編集不可です。
1.1.1.14  root     2351: <q>The backend file is also updated immediately when edited.
1.1.1.16  root     2352: The only last 8 bytes are not editable since there are the clock registers.</q>
1.1.1.14  root     2353: <li>Bitmap framebuffer (LUNA Only) … 共通プレーンは書き込み不可です。
                   2354: <q>The common plane is not editable.</q>
                   2355: <li>SRAM (X68030 Only) …
                   2356: 編集するとただちにファイルも更新します。
                   2357: <q>The backend file is also updated immediately when edited.</q>
1.1.1.23  root     2358: <li>TVRAM、GVRAM とパレット (X68030 Only) <q>Text VRAM, Graphic VRAM and palette</q>
1.1.1.14  root     2359: </ul>
                   2360: </div>
1.1.1.16  root     2361: <?php H5end(); ?>
1.1.1.14  root     2362: 
1.1.1.24! root     2363: <?php H5("", "ページテーブルモニタ <q>Page Table Monitor</q>"); ?>
        !          2364: <div class="main">
        !          2365: 68030 と 68040 のページテーブルを一覧できるモニタです。
        !          2366: 88200 は未対応です。
        !          2367: 68030 はバリエーションが多すぎるのですべてには対応していません。
        !          2368: <q>This is a page table monitor on 68030 and 68040.
        !          2369: It doesn't support 88200 yet.
        !          2370: It doesn't support all variations of 68030 because it's too complex.</q>
        !          2371: <ul>
        !          2372: <li>現状、段数は TIC までの3段階まで、FCL には未対応です。
        !          2373: <q>Up to 3-levels (From TIA to TIC). No FCL supported.</q>
        !          2374: <li>アーリーターミネーションと間接ディスクリプタは表示で区別していませんので
        !          2375: 自身で判断してください。
        !          2376: <q>An early termination and indirect descriptor are not distinguished
        !          2377: in the display.</q>
        !          2378: <li>ルートポインタの切り替えは、68040 ではそのまま
        !          2379: SRP/URP レジスタの切り替えです。
        !          2380: 68030 では TC によって SRP/CRP の使い方が変わるため、
        !          2381: SRP/CRP の切り替えではなく
        !          2382: スーパーバイザ状態/ユーザ状態でのルートポインタを選択します。
        !          2383: <q>The root pointer switching on 68040 is SRP/URP as is.
        !          2384: On 68030, it switches supervisor-state/user-state.</q>
        !          2385: </ul>
        !          2386: </div>
        !          2387: <?php H5end(); ?>
        !          2388: 
1.1.1.15  root     2389: <?php H5("", "デバイスマップモニタ <q>Device Map Monitor</q>"); ?>
                   2390: <div class="main">
                   2391: m68k/m88k バスに接続されているデバイスを表示します。
                   2392: 32ビットアドレスのうち上位 8 ビット、256個分を表示しています。
                   2393: 1枠が 16MB になります。
                   2394: また、X68030 ではこのうち 24ビット空間を別モニタで表示します。
                   2395: こちらは 1枠 8KB x 2048個です。
                   2396: どちらも内部構造を表示しているだけなので名前に馴染みがない場合があるかもしれません。
1.1.1.16  root     2397: NEWS のデバイスマップは内部構造の都合上、
                   2398: 内部状態を正確に反映していないケースがあるかも知れません。
1.1.1.15  root     2399: </div>
1.1.1.16  root     2400: <?php H5end(); ?>
1.1.1.15  root     2401: 
1.1.1.14  root     2402: <?php H5("", "キー入力モード <q>Key input mode</q>"); ?>
1.1.1.10  root     2403: <div class="main">
1.1.1.13  root     2404: LUNA も X68030 もキーボードは通常日本語キーボードです
                   2405: (LUNA には英語キーボードも存在するようですが…)。
1.1.1.10  root     2406: そのため、ホストが日本語キーボードの場合とそうでない場合のために
                   2407: 2つの入力モードを用意しています。
                   2408: どちらも一長一短があります。
1.1.1.13  root     2409: <q>LUNA and X68030 has the Japanese keyboard
                   2410: (though I ever heard there are US keyboard for LUNA...).
1.1.1.10  root     2411: So nono provides two input modes
                   2412: for Japanese keyboard users and non Japanese keyboard users.
                   2413: Both have advantages and disadvantages.</q>
                   2414: <p>
                   2415: JP キーボードモードは、ホストが日本語キーボードであることを前提に
                   2416: 対応するキーの押下、開放をその都度 VM に入力します。
                   2417: メリットとしては動作が実機に近くなり、
                   2418: 特にキーリピート(をハードウェアが行わないこと)も忠実に再現可能です。
                   2419: デメリットは ALT + TAB やアクセラレータキーでメニューを開く場合などに
                   2420: キー入力が残ることがあることです
                   2421: (キーを押した後でフォーカスが外れるとキーを離したことが
                   2422: アプリケーションに通知されないため)。
                   2423: またホストが日本語キーボードでなければ使いづらいです。
                   2424: <q>JP keyboard mode assumes that the host uses the Japanese keyboard.
                   2425: Each time you presses and releases a key,
                   2426: nono sends the corresponding key-pressed or key-released to the VM.
                   2427: One advantage is that it's close to the real machine behavior,
                   2428: and another is that it can reproduce
                   2429: the LUNA keyboard itself does not perform a key repeat.
                   2430: On the other hand,
                   2431: one disadvantage is that key sometimes remains pressed,
                   2432: especially when you enter ALT + TAB to switch the application
                   2433: or enter accelerator key to open the menu
                   2434: (If the application loses the focus after the key is pressed,
                   2435: the application will not receive the subsequent key release).
                   2436: And another disadvantage is that
1.1.1.11  root     2437: it will be hard to use for non Japenese keyboard users.</q>
1.1.1.10  root     2438: <p>
                   2439: 一方、キャラクタ入力モードは、ホストから入力された「文字」を
1.1.1.13  root     2440: 再び LUNA/X68030 のキーコードに解釈し直して VM に入力するモードです。
1.1.1.10  root     2441: 例えばゲスト OS に "@" を入力したい場合、
                   2442: US キーボードなら [SHIFT] + [2] を、
                   2443: JP キーボードなら [@] キーを押しますが、
                   2444: どちらも VM には [@] キーの押下、[@] キーの開放が連続して送られます。
                   2445: US キーボードで [SHIFT] を押したことは通知されません。
                   2446: 逆に "=" を入力したい場合、
                   2447: US キーボードなら [=] キーを、
                   2448: JP キーボードなら [SHIFT] + [-] を押しますが、
                   2449: どちらも VM には
                   2450: [SHIFT]押下 → [-]押下 → [-]開放 → [SHIFT]開放のシーケンスが送られます。
                   2451: このようにホストキーボードのレイアウトによらず、
                   2452: 入力したい文字が入力できるようになり、
                   2453: 通常のタイピングで困ることはないと思います。
                   2454: デメリットは、通常の文字入力以外のタイピングはほぼ出来ないことです。
                   2455: [SHIFT] キーを押したままにすることや、
                   2456: 文字が入力できないキーの組み合わせは入力出来ません。
                   2457: もう一つのデメリットはキーリピート(をハードウェアが行わないこと)が再現できず、
                   2458: ホスト側のキーリピートが効いてしまうことです
                   2459: (本来キーリピートが動作しない ROM やブートローダでもキーリピートが効くことは
                   2460: 一般ユーザからはメリットに感じられるかも知れませんが)。
                   2461: <q>In contrast, in the character mode, when you type a character,
1.1.1.13  root     2462: nono re-converts it into the LUNA/X68030's key code and sends it to the VM.
1.1.1.10  root     2463: For example if you want to type "@" in the guest OS,
                   2464: you would press [SHIFT] + [2] on the US keyboard or [@] on the JP keyboard.
                   2465: In both cases, the sequence of
                   2466: [@]-pressed and [@]-released will be sent to the VM.
                   2467: Note that the fact that you pressed [SHIFT] key on the US keyboard
                   2468: will not be sent to the VM.
                   2469: Another example, if you want to type "=",
                   2470: you would press [=] on the US keyboard or [SHIFT] + [-] on the JP keyboard.
                   2471: In both cases, the sequence of
                   2472: [SHIFT]-pressed, [-]-pressed, [-]-released, and [SHIFT]-released
                   2473: will be sent to the VM.
                   2474: Thus, you can type what character you want to type,
                   2475: regardless of your keyboard layout.
                   2476: Of course there are some disadvantages.
                   2477: Firstly, it's hard to type any special characters,
                   2478: for example, you can not type any key conbinations
                   2479: that don't generate a character.
                   2480: Or you can not hold [SHIFT] key pressed.
                   2481: Secondly, the key repeat works (by the host),
                   2482: even though it should not work as a correct emulation
                   2483: (Although some of you may feel it an advantage).</q>
                   2484: </div>
1.1.1.14  root     2485: <?php H5end(); ?>
1.1.1.10  root     2486: 
1.1.1.14  root     2487: <?php H5("","キャラクタ入力モードのキーコード対応表 " .
                   2488:        "<q>Keycode table in the character mode</q>"); ?>
1.1.1.10  root     2489: <div class="main">
                   2490: キャラクタ入力モードでの、ホストから入力した文字と
                   2491: VM に送信されるキーの対応は次の通りです。
                   2492: ファンクションキーとカーソルキーは文字ではありませんが
                   2493: 特別に対応しています。
1.1.1.13  root     2494: ここに記載のないゲストキーはソフトウェアキーボードからのみ入力できます。
1.1.1.10  root     2495: <q>The following table shows the correspondence between
                   2496: the character that typed from the host
                   2497: and the key that will be sent to the VM.
                   2498: nono can recognize the function keys and arrow keys.
1.1.1.13  root     2499: The keys that not listed in this table can
1.1.1.10  root     2500: only be typed from the software keyboard window.</q>
                   2501: <p>
                   2502: <center>
                   2503: <style type="text/css">
                   2504: .keytable-whole {
                   2505:        display: inline-block;
                   2506:        vertical-align: top;
1.1.1.16  root     2507:        border-bottom: solid 1px;
1.1.1.10  root     2508: }
                   2509: .keytable-middle {
                   2510:        margin-left: 1em;
                   2511:        margin-right: 1em;
                   2512: }
                   2513: 
                   2514: .keytable-head {
                   2515:        text-align: left;
1.1.1.16  root     2516:        border-top:    solid 1px;
1.1.1.10  root     2517:        border-bottom: solid 1px;
                   2518: }
                   2519: .keytable-headl {
                   2520:        padding-right: 1em;
1.1.1.16  root     2521:        border-left:   solid 1px;
                   2522:        border-right:  solid 1px;
                   2523: }
                   2524: .keytable-headr {
                   2525:        border-right:  solid 1px;
1.1.1.10  root     2526: }
                   2527: 
                   2528: .keytable-tdl {
                   2529:        padding-right: 1em;
1.1.1.16  root     2530:        border-left:   solid 1px;
                   2531:        border-right:  solid 1px;
1.1.1.10  root     2532: }
                   2533: .keytable-tdr {
1.1.1.16  root     2534:        border-right:  solid 1px;
1.1.1.10  root     2535: }
                   2536: </style>
                   2537: <?php
                   2538:        $str = <<<__EOM__
                   2539:                <tt>a</tt> 〜 <tt>z</tt>       [A] 〜 [Z]
                   2540:                <tt>0</tt> 〜 <tt>9</tt>       [0] 〜 [9]
                   2541:                SPACE           [SPACE]
                   2542:                <tt>-</tt>      [-]
                   2543:                <tt>^</tt>      [^]
                   2544:                <tt>&bsol;</tt> [&bsol;]
                   2545:                <tt>@</tt>      [@]
                   2546:                <tt>[</tt>      [[]
                   2547:                <tt>;</tt>      [;]
                   2548:                <tt>:</tt>      [:]
                   2549:                <tt>]</tt>      []]
                   2550:                <tt>,</tt>      [,]
                   2551:                <tt>.</tt>      [.]
                   2552:                <tt>/</tt>      [/]
                   2553: 
                   2554:                <tt>A</tt> 〜 <tt>Z</tt>       [SHIFT]+[A] 〜 [SHIFT]+[Z]
                   2555:                <tt>!</tt>      [SHIFT]+[1]
                   2556:                <tt>"</tt>      [SHIFT]+[2]
                   2557:                <tt>#</tt>      [SHIFT]+[3]
                   2558:                <tt>$</tt>      [SHIFT]+[4]
                   2559:                <tt>%</tt>      [SHIFT]+[5]
                   2560:                <tt>&amp;</tt>  [SHIFT]+[6]
                   2561:                <tt>'</tt>      [SHIFT]+[7]
                   2562:                <tt>(</tt>      [SHIFT]+[8]
                   2563:                <tt>)</tt>      [SHIFT]+[9]
                   2564:                <tt>=</tt>      [SHIFT]+[-]
                   2565:                <tt>~</tt>      [SHIFT]+[^]
                   2566:                <tt>|</tt>      [SHIFT]+[&bsol;]
                   2567:                <tt>`</tt>      [SHIFT]+[@]
                   2568:                <tt>{</tt>      [SHIFT]+[[]
                   2569:                <tt>+</tt>      [SHIFT]+[;]
                   2570:                <tt>*</tt>      [SHIFT]+[:]
                   2571:                <tt>]</tt>      [SHIFT]+[]]
                   2572:                <tt>&lt;</tt>   [SHIFT]+[,]
                   2573:                <tt>&gt;</tt>   [SHIFT]+[.]
                   2574:                <tt>?</tt>      [SHIFT]+[/]
                   2575:                <tt>_</tt>      [SHIFT]+[_]
                   2576: 
                   2577:                F1 〜 F10      [PF1] 〜 [PF10]
1.1.1.14  root     2578:                F11             [PF10]
1.1.1.10  root     2579:                ↑             [↑]
                   2580:                ←             [←]
                   2581:                →             [→]
                   2582:                ↓             [↓]
1.1.1.13  root     2583:                <tt>^@</tt>     [CTRL]+[@]
                   2584:                <tt>^A</tt> 〜 <tt>^Z</tt>     [CTRL]+[A] 〜 [CTRL]+[Z]
                   2585:                <tt>^[</tt>     [ESC]
                   2586:                <tt>^\</tt>     [CTRL]+[&bsol;]
                   2587:                <tt>^]</tt>     [CTRL]+[]]
                   2588:                <tt>^^</tt>     [CTRL]+[^]
                   2589:                <tt>^_</tt>     [CTRL]+[_]
                   2590:                <tt>^H</tt>     [BS]
                   2591:                <tt>^I</tt>     [TAB]
                   2592:                <tt>^M</tt>     [Enter]
1.1.1.10  root     2593: __EOM__;
                   2594:        $table = array();
                   2595:        $table[0] = array();
                   2596:        $table[1] = array();
                   2597:        $table[2] = array();
                   2598:        $i = 0;
1.1.1.16  root     2599:        foreach (explode("\n", $str) as $s) {
1.1.1.10  root     2600:                if ($s == "") {
                   2601:                        $i++;
                   2602:                        continue;
                   2603:                }
                   2604:                $s = preg_replace("/^\t+/", "", $s);
                   2605:                list ($hkey, $gkey) = preg_split("/\t+/", $s);
                   2606:                $table[$i][] = array($hkey, $gkey);
                   2607:        }
                   2608: 
                   2609:        for ($j = 0; $j < count($table); $j++) {
                   2610:                switch ($j) {
                   2611:                 case 0:        $classname = "left";    break;
1.1.1.13  root     2612:                 default:       $classname = "middle";  break;
                   2613:                 case 3:        $classname = "right";   break;
1.1.1.10  root     2614:                }
                   2615:                print "<table class='keytable-whole keytable-${classname}'";
                   2616:                print " cellspacing=0 cellpadding=1>\n";
                   2617:                print "<tr>";
                   2618:                print "<th class='keytable-head keytable-headl'>HostChar";
                   2619:                print "<th class='keytable-head keytable-headr'>GuestKey\n";
                   2620:                for ($i = 0; $i < count($table[$j]); $i++) {
                   2621:                        list ($h, $g) = $table[$j][$i];
                   2622:                        print "<tr>";
                   2623:                        print "<td class='keytable-tdl'>{$h}";
                   2624:                        print "<td class='keytable-tdr'>${g}\n";
                   2625:                }
                   2626:                print "</table>\n";
                   2627:        }
                   2628: ?>
                   2629: </center>
                   2630: </div>
1.1.1.14  root     2631: <?php H5end(); ?>
1.1.1.10  root     2632: 
1.1.1.14  root     2633: <?php H5("", "JP キーボードモードのキーコード対応表 " .
                   2634:        "<q>Keycode table in the JP keyboard mode</q>"); ?>
1.1.1.10  root     2635: <div class="main">
                   2636: JP キーボードモードでの、ホストキーと VM に送信されるキーの対応は次の通りです。
1.1.1.13  root     2637: ここに記載のないキーはソフトウェアキーボードからのみ入力出来ます。
1.1.1.10  root     2638: <q>The following table shows the correspondence between
                   2639: the host key and the guest key.
1.1.1.16  root     2640: The keys that not listed in this table can only be entered from
1.1.1.10  root     2641: the software keyboard window.</q>
                   2642: <p>
                   2643: <center>
                   2644: <?php
                   2645:        $str = <<<__EOM__
                   2646:                [0] 〜 [9]             [0] 〜 [9]
                   2647:                [A] 〜 [Z]             [A] 〜 [Z]
                   2648:                [-]                             [-]
                   2649:                [^]                             [^]
                   2650:                [&bsol;]                [&bsol;]
                   2651:                [@]                             [@]
                   2652:                [[]                             [[]
                   2653:                [;]                             [;]
                   2654:                [:]                             [:]
                   2655:                []]                             []]
                   2656:                [,]                             [,]
                   2657:                [.]                             [.]
1.1.1.16  root     2658: 
1.1.1.10  root     2659:                [/]                             [/]
                   2660:                [_]                             [_]
                   2661:                [ESC]                   [ESC]
                   2662:                [TAB]                   [TAB]
                   2663:                [CTRL]                  [CTRL]
1.1.1.13  root     2664:                [SHIFT-L]               [SHIFT-L]
                   2665:                [SHIFT-R]               [SHIFT-R]
1.1.1.16  root     2666:                [Enter]                 [Enter]
1.1.1.13  root     2667:                [↑]                   [↑]
                   2668:                [←]                   [←]
                   2669:                [→]                   [→]
                   2670:                [↓]                   [↓]
                   2671: 
1.1.1.16  root     2672:                [BS]                    [BS]
                   2673:                [Delete]                [DEL]
                   2674:                [F1] 〜 [F10]  [PF1] 〜 [PF10]
                   2675:                [F11]                   [PF10]
1.1.1.10  root     2676:                Numpad[0]〜[9] Numpad[0]〜[9]
                   2677:                Numpad[+]               Numpad[+]
                   2678:                Numpad[-]               Numpad[-]
                   2679:                Numpad[*]               Numpad[*]
                   2680:                Numpad[/]               Numpad[/]
                   2681:                Numpad[=]               Numpad[=]
                   2682:                Numpad[.]               Numpad[.]
                   2683:                Numpad[Enter]   Numpad[Enter]
1.1.1.16  root     2684: 
                   2685:                [Home]                  [HOME]
                   2686:                [Insert]                [INS]
                   2687:                [PageUp]                [ROLL UP]
                   2688:                [PageDown]              [ROLL DOWN]
                   2689:                [End]                   [UNDO]
1.1.1.10  root     2690: __EOM__;
                   2691:        $table = array();
1.1.1.16  root     2692:        $table[0] = array();    // 1段目(共通)
                   2693:        $table[1] = array();    // 1段目(共通)
                   2694:        $table[2] = array();    // 1段目(共通)
                   2695:        $table[3] = array();    // 2段目(X68030)
1.1.1.10  root     2696:        $i = 0;
1.1.1.16  root     2697:        foreach (explode("\n", $str) as $s) {
1.1.1.10  root     2698:                if ($s == "") {
                   2699:                        $i++;
                   2700:                        continue;
                   2701:                }
                   2702:                $s = preg_replace("/^\t+/", "", $s);
                   2703:                list ($hkey, $gkey) = preg_split("/\t+/", $s);
                   2704:                $table[$i][] = array($hkey, $gkey);
                   2705:        }
                   2706: 
                   2707:        for ($j = 0; $j < count($table); $j++) {
1.1.1.16  root     2708:                if ($j == 3) {
                   2709:                        print "<br>\n";
                   2710:                }
                   2711: 
                   2712:                $caption = "";
1.1.1.10  root     2713:                switch ($j) {
                   2714:                 case 0:        $classname = "left";    break;
                   2715:                 case 1:        $classname = "middle";  break;
                   2716:                 case 2:        $classname = "right";   break;
1.1.1.16  root     2717:                 case 3:        $classname = "left";    $caption = "(X68030 Only)";     break;
1.1.1.10  root     2718:                }
                   2719:                print "<table class='keytable-whole keytable-${classname}'";
                   2720:                print " cellspacing=0 cellpadding=0>\n";
1.1.1.16  root     2721:                if ($caption != "") {
                   2722:                        print "<caption>{$caption}</caption>\n";
                   2723:                }
1.1.1.10  root     2724:                print "<tr>";
                   2725:                print "<th class='keytable-head keytable-headl'>HostKey";
                   2726:                print "<th class='keytable-head keytable-headr'>GuestKey\n";
                   2727:                for ($i = 0; $i < count($table[$j]); $i++) {
                   2728:                        list ($h, $g) = $table[$j][$i];
                   2729:                        print "<tr>";
                   2730:                        print "<td class='keytable-tdl'>{$h}";
                   2731:                        print "<td class='keytable-tdr'>${g}\n";
                   2732:                }
                   2733:                print "</table>\n";
                   2734:        }
                   2735: ?>
                   2736: </center>
                   2737: </div>
1.1.1.14  root     2738: <?php H5end(); ?>
1.1.1.10  root     2739: 
1.1.1.14  root     2740: <?php H5("", "キーリピート <q>Key Repeat</q>"); ?>
1.1.1.7   root     2741: <div class="main">
                   2742: LUNA では、キーボードがハードウェア側でキーリピートを行わず、
                   2743: ソフトウェア(OS など)がキーリピートの処理を行います。
                   2744: そのため、キーリピートを実装していない LUNA の PROM や
                   2745: NetBSD/luna68k のブートローダではキーリピートは起きず、
                   2746: キーリピートを実装している NetBSD/luna68k カーネルではキーリピートが起こせます。
1.1.1.8   root     2747: キーリピートを起こす間隔をゲストのソフトウェアが測定しているということは、
1.1.1.7   root     2748: VM が高速動作するとキーリピートもそれに合わせて発生することになり、
                   2749: これをホスト側から防ぐ手段はありません。
1.1.1.23  root     2750: そこで nono ではキー入力が発生している間
1.1.1.7   root     2751: (キーが一つでも押されてからキーが全て離されるまでの間)、
                   2752: 高速モードが指示されていても VM を一時的に等速モードに落として実行します。
                   2753: 上記のアイコンがそれを区別しているのはこのためです。
                   2754: そのため、何らかの理由でキーが入りっぱなしになった場合
                   2755: (ALT + TAB やアクセラレータキーでメニューを開くと起きがちです)
                   2756: 高速モードが抑制されたままということが起きえます。
                   2757: その場合はソフトウェアキーボードからキー入力を解除するなどしてください。
1.1.1.10  root     2758: <q>On LUNA,
1.1.1.7   root     2759: key repeat is done by software(OS), not by the keyboard hardware.
                   2760: For this reason,
                   2761: key repeat doesn't occur on LUNA's PROM or NetBSD/luna68k's bootloader
                   2762: that don't implement it, and
                   2763: key repeat occurs on NetBSD/luna68k kernel that implements it.
1.1.1.8   root     2764: Since the timing of key repeat is measured by the guest software,
1.1.1.7   root     2765: if the VM is running faster than the real,
                   2766: the key repeat will occur faster, too.
                   2767: The host application doesn't have the way to avoid it.
                   2768: Therefore, nono will temporarily suppress the full speed mode
1.1.1.23  root     2769: while any keys are pressed on LUNA.
1.1.1.7   root     2770: That is why the above-mentioned icon distinguishes them.
1.1.1.8   root     2771: If keys continue to be pressed for some reasons,
1.1.1.7   root     2772: the VM also continues to run syncronized mode.
1.1.1.11  root     2773: In this case, you can resolve it by using the software keyboard window.</q>
1.1.1.7   root     2774: </div>
1.1.1.14  root     2775: <?php H5end(); ?>
                   2776: <?php H4end(); ?>
1.1.1.7   root     2777: 
                   2778: 
1.1.1.14  root     2779: <?php H4("tryit", "実行してみる <q>Try it</q>"); ?>
                   2780: <?php H5("", "NetBSD/luna68k を実行してみる <q>Try NetBSD/luna68k</q>"); ?>
1.1       root     2781: <div class="main">
1.1.1.8   root     2782: つついさんが NetBSD/luna68k 9.2 の liveimage を用意されています。
                   2783: <q>Tsutsui-san has provided a liveimage of NetBSD/luna68k 9.2.</q>
                   2784: <dl>
1.1.1.11  root     2785: <dd><a href="https://twitter.com/tsutsuii/status/1436381589211017217"
                   2786: >https://twitter.com/tsutsuii/status/1436381589211017217</a><br>
1.1.1.8   root     2787: </dl>
                   2788: ここではこれを起動してみます。<q>Let's try it.</q>
1.1.1.2   root     2789: <br>
                   2790: <ol>
                   2791: <li>どこかに nono 用のディレクトリを用意し(例えば ~/nono/)、
1.1       root     2792: その中に VM ディレクトリを用意します (例えば ~/nono/luna/)。
1.1.1.3   root     2793: <q>Create a directory somewhere for nono (for example ~/nono/),
1.1.1.8   root     2794: and create subdirectories for individual VMs in it
                   2795: (for example ~/nono/luna/).</q>
1.1       root     2796: 
1.1.1.3   root     2797: <li>以下のリンクからイメージファイルをダウンロードして展開し、
1.1.1.2   root     2798: VM ディレクトリ ~/nono/luna/ に置きます。
1.1.1.3   root     2799: <q>Download imagefile from the following link,
1.1.1.7   root     2800: extract it and place it in the VM directory, ~/nono/luna/.</q>
1.1.1.3   root     2801: <blockquote>
1.1.1.11  root     2802: <a href="http://teokurebsd.org/netbsd/liveimage/20210910-luna68k/"
                   2803: >http://teokurebsd.org/netbsd/liveimage/20210910-luna68k/</a>
1.1.1.3   root     2804: </blockquote>
1.1.1.2   root     2805: 
1.1.1.8   root     2806: <li>以下の内容の設定ファイル nono.cfg を VM ディレクトリ ~/nono/luna/
                   2807: に作成します。
1.1.1.7   root     2808: <q>Create a configuration file nono.cfg in the VM directory, ~/nono/luna/,
1.1.1.19  root     2809: with following contents.</q>
1.1.1.2   root     2810: <blockquote class="file"><pre>
                   2811: vmtype = luna
1.1.1.11  root     2812: spc0-id6-image = hd,liveimage-luna68k-with-packages-20210910.img
1.1.1.2   root     2813: </pre></blockquote>
1.1.1.8   root     2814: 
1.1.1.2   root     2815: <li><tt>nono -c ~/nono/luna</tt> で起動します
                   2816: (VM ディレクトリに自動的に NVRAM.DAT が作られます)。
                   2817: <q>Run as <tt>nono -c ~/nono/luna</tt>.
1.1.1.4   root     2818: (NVRAM.DAT will be created automatically in the VM directory)</q>
1.1.1.13  root     2819: 
1.1.1.2   root     2820: <li>Emulated ROM Monitor が起動するので、
                   2821: 初回は以下のように入力すると NetBSD が起動します。
                   2822: <q>The emulated ROM Monitor will be executed.
                   2823: Then, only for the first time,
                   2824: entering the following can boot NetBSD.</q>
1.1.1.8   root     2825: <blockquote><pre>
                   2826: k&#x23ce;
                   2827: &#x23ce;
                   2828: &#x23ce;
                   2829: d&#x23ce;
                   2830: boot&#x23ce;
                   2831: g&#x23ce;
                   2832: x&#x23ce;
                   2833: </pre></blockquote>
                   2834: 画面はこんな感じのはずです (太字が入力部分)。
                   2835: <q>You will see a screen like this.  The bold text indicates
                   2836: the characters you need to enter.</q>
1.1.1.2   root     2837: <blockquote class="file"><pre>
1.1.1.11  root     2838: NONO <?=$nono_ver?> Emulated ROM Monitor for LUNA-I
1.1.1.8   root     2839: 
                   2840: ** NVRAM Initialized.
                   2841: 
                   2842: &gt;<b>k&#x23ce;</b>
                   2843: controller: dk  ?<b>&#x23ce;</b>
                   2844: drive unit: 0  ?<b>&#x23ce;</b>
                   2845: partition : c  ?<b>d&#x23ce;</b>
                   2846: filename  : vmunix  ?<b>boot&#x23ce;</b>
                   2847: &gt;<b>g&#x23ce;</b>
                   2848: Loaded.  Entry point = $00700000
                   2849: &gt;<b>x&#x23ce;</b>
1.1.1.2   root     2850: </pre></blockquote>
                   2851: この内容は NVRAM.DAT に記録されているので次回以降は直接 NetBSD が起動します。
1.1.1.7   root     2852: <q>The information you have just entered is recorded in the NVRAM,
1.1.1.13  root     2853: so next time it will boot NetBSD automatically.</q>
1.1.1.8   root     2854: <li>初回起動時、
                   2855: Updating fontconfig cache はあほみたいに時間がかかりますが、
                   2856: nono がハングアップしてるわけではありません(>_<)。
1.1.1.13  root     2857: また初回は起動後数時間めちゃくちゃ重たいですが、
1.1.1.8   root     2858: これはバックグラウンドで makemandb が動くためで
                   2859: nono のせいではありません(>_<)。
                   2860: <q>At the first boot, you will see the console stops after printing
                   2861: "Updating fontconfig cache".
                   2862: This is because the infamous fontconfig takes very looooong time.
                   2863: nono would not have hang-up.
1.1.1.13  root     2864: In addition, at the first boot, you will feel it's too heavy for several hours.
1.1.1.8   root     2865: This is because the infamous makemandb(8) runs heavily in the background
                   2866: for a looooong time.
                   2867: It's very sad to me that these two accidents which are far from the ideal
1.1.1.12  root     2868: are the first experiences of newcomers.</q>
1.1.1.8   root     2869: 
                   2870: <li>終了する時は root
                   2871: ユーザで &ldquo;<tt>shutdown -p now</tt>&rdquo; を実行してください。
                   2872: LUNA はソフトウェアから電源オフでき、
                   2873: VM の電源オフで nono も終了します。
                   2874: <q>To quit, type &ldquo;<tt>shutdown -p now</tt>&rdquo; as the root user.
                   2875: LUNA can be powered off by software,
                   2876: and nono will terminate when the VM is powered off.</q>
                   2877: </ol>
                   2878: </div>
1.1.1.14  root     2879: <?php H5end(); ?>
1.1.1.8   root     2880: 
1.1.1.14  root     2881: <?php H5("", "OpenBSD/luna88k を実行してみる <q>Try OpenBSD/luna88k</q>"); ?>
1.1.1.8   root     2882: <div class="main">
1.1.1.22  root     2883: あおやまさんが OpenBSD/luna88k 7.7 の liveimage を用意されています。
1.1.1.17  root     2884: <q>Aoyama-san has provided a liveimage of OpenBSD/luna88k 7.6.</q>
1.1.1.8   root     2885: <dl>
1.1.1.22  root     2886: <dd><a href="https://bsd.network/@ao_kenji/114436150104520496"
                   2887: >https://bsd.network/@ao_kenji/114436150104520496</a>
1.1.1.8   root     2888: </dl>
                   2889: ここではこれを起動してみます。<q>Let's try it.</q>
                   2890: <br>
                   2891: <ol>
                   2892: <li>どこかに nono 用のディレクトリを用意し(例えば ~/nono/)、
                   2893: その中に VM ディレクトリを用意します (例えば ~/nono/luna88k/)。
                   2894: <q>Create a directory somewhere for nono (for example ~/nono/),
                   2895: and create subdirectories for individual VMs in it
                   2896: (for example ~/nono/luna88k/).</q>
                   2897: 
1.1.1.22  root     2898: <li>以下のリンクから liveimage-luna88k-raw-20250518.img.gz
1.1.1.8   root     2899: をダウンロードして展開し、
                   2900: VM ディレクトリ ~/nono/luna88k/ に置きます。
1.1.1.22  root     2901: <q>Download liveimage-luna88k-raw-20250518.img.gz from the following link,
1.1.1.8   root     2902: extract it and place it in the VM directory, ~/nono/luna88k/.</q>
                   2903: <blockquote>
                   2904: <a href="http://www.nk-home.net/~aoyama/liveimage/"
                   2905: >http://www.nk-home.net/~aoyama/liveimage/</a>
                   2906: </blockquote>
                   2907: 
                   2908: <li>以下の内容の設定ファイル nono.cfg を VM ディレクトリ ~/nono/luna88k/
                   2909: に作成します。
                   2910: <q>Create a configuration file nono.cfg in the VM directory, ~/nono/luna88k/,
1.1.1.19  root     2911: with following contents.</q>
1.1.1.8   root     2912: <blockquote class="file"><pre>
                   2913: vmtype = luna88k
1.1.1.17  root     2914: spc0-id6-image = hd,liveimage-luna88k-raw-20241013.img
1.1.1.8   root     2915: </pre></blockquote>
                   2916: 
                   2917: <li><tt>nono -c ~/nono/luna88k</tt> で起動します
                   2918: (VM ディレクトリに自動的に NVRAM.DAT が作られます)。
                   2919: <q>Run as <tt>nono -c ~/nono/luna88k</tt>.
                   2920: (NVRAM.DAT will be created automatically in the VM directory)</q>
                   2921: <li>Emulated ROM Monitor が起動するので、
                   2922: 初回は以下のように入力すると OpenBSD が起動します。
                   2923: <q>The emulated ROM Monitor will be executed.
                   2924: Then, only for the first time,
                   2925: entering the following can boot OpenBSD.</q>
                   2926: <blockquote><pre>
                   2927: nvram boot_filename boot&#x23ce;
                   2928: y
                   2929: b&#x23ce;
                   2930: </pre></blockquote>
                   2931: 画面はこんな感じのはずです (太字が入力部分)。
                   2932: <q>You will see a screen like this.  The bold text indicates
                   2933: the characters you need to enter.</q>
                   2934: <blockquote class="file"><pre>
1.1.1.14  root     2935: NONO <?=$nono_ver?> Emulated ROM Monitor for LUNA-88K
1.1.1.8   root     2936: 
                   2937: ** NVRAM Initialized.
                   2938: 
                   2939: N&gt;<b>nvram boot_filename boot&#x23ce;</b>
                   2940: Update boot_filename : "vmunix" -&gt; "boot" (Y/[N]):<b>y</b>
                   2941: Updated
                   2942: N&gt;<b>b&#x23ce;</b>
                   2943: </pre></blockquote>
                   2944: この内容は NVRAM.DAT に記録されているので次回以降は直接 OpenBSD が起動します。
                   2945: <q>The information you have just entered is recorded in the NVRAM,
1.1.1.13  root     2946: so next time it will boot OpenBSD automatically.</q>
1.1.1.8   root     2947: 
                   2948: <li>終了する時は root
                   2949: ユーザで &ldquo;<tt>shutdown -p now</tt>&rdquo; を実行してください。
1.1.1.12  root     2950: LUNA-88K はソフトウェアから電源オフでき、
1.1.1.8   root     2951: VM の電源オフで nono も終了します。
                   2952: <q>To quit, type &ldquo;<tt>shutdown -p now</tt>&rdquo; as the root user.
1.1.1.12  root     2953: LUNA-88K can be powered off by software,
1.1.1.8   root     2954: and nono will terminate when the VM is powered off.</q>
1.1.1.2   root     2955: </ol>
1.1       root     2956: </div>
1.1.1.14  root     2957: <?php H5end(); ?>
                   2958: 
1.1       root     2959: 
1.1.1.14  root     2960: <?php H5("", "NetBSD/x68k を実行してみる <q>Try NetBSD/x68k</q>"); ?>
1.1.1.13  root     2961: <div class="main">
1.1.1.19  root     2962: つついさんが NetBSD/x68k 10.1 の liveimage を用意されています。
1.1.1.13  root     2963: ここではこれを起動してみます。
1.1.1.19  root     2964: <q>Tsutsui-san has provided a liveimage of NetBSD/x68k 10.1.
1.1.1.16  root     2965: Let's try it.</q>
1.1.1.13  root     2966: <br>
                   2967: <ol>
                   2968: <li>どこかに nono 用のディレクトリを用意し(例えば ~/nono/)、
                   2969: その中に VM ディレクトリを用意します (例えば ~/nono/x68k/)。
                   2970: <q>Create a directory somewhere for nono (for example ~/nono/),
                   2971: and create subdirectories for individual VMs in it
                   2972: (for example ~/nono/x68k/).</q>
                   2973: 
1.1.1.19  root     2974: <li>以下のサイトから
                   2975: 「パッケージインストール設定済み版」か
                   2976: 「インストーラでインストールしたところまでの未設定版」の
                   2977: お好みのほうをダウンロードします。
                   2978: 迷ったら「パッケージインストール設定済み版」がよいでしょう。
                   2979: ダウンロードできたら展開して、VM ディレクトリ ~/nono/x68k/ に置きます。
                   2980: <q>Download your favorite one of with-packages or plain-install
                   2981: from the following site.
                   2982: Extract it and place it in the VM directory, ~/nono/x68k/.</q>
1.1.1.14  root     2983: <blockquote>
1.1.1.19  root     2984: <a href="http://www.ceres.dti.ne.jp/tsutsui/netbsd/liveimage/x68k.html"
                   2985: >http://www.ceres.dti.ne.jp/tsutsui/netbsd/liveimage/x68k.html</a>
1.1.1.13  root     2986: </blockquote>
                   2987: 
                   2988: <li>以下の内容の設定ファイル nono.cfg を VM ディレクトリ ~/nono/x68k/
                   2989: に作成します。
                   2990: <q>Create a configuration file nono.cfg in the VM directory, ~/nono/x68k/,
1.1.1.19  root     2991: with following contents.</q>
1.1.1.13  root     2992: <blockquote class="file"><pre>
                   2993: vmtype = x68030
1.1.1.19  root     2994: spc0-id0-image = hd,liveimage-x68k-with-packages-20250106.hds
1.1.1.13  root     2995: </pre></blockquote>
                   2996: 
1.1.1.22  root     2997: <li><tt>nono -c ~/nono/x68k</tt> で起動します
1.1.1.23  root     2998: (VM ディレクトリに自動的に SRAM.DAT が作られます)。
1.1.1.22  root     2999: <q>Run as <tt>nono -c ~/nono/x68k</tt>
1.1.1.23  root     3000: (SRAM.DAT will be created automatically in the VM directory).
1.1.1.13  root     3001: 
1.1.1.22  root     3002: <li>初回の NetBSD/x68k 起動後数時間はめちゃくちゃ重たいですが、
1.1.1.13  root     3003: これはバックグラウンドで makemandb が動くためで
                   3004: nono のせいではありません(>_<)。
1.1.1.22  root     3005: <q>At the first NetBSD/x68k boot,
                   3006: you will feel it's too heavy for several hours.
1.1.1.13  root     3007: This is because the infamous makemandb(8) runs heavily in the background
                   3008: for a looooong time.
1.1.1.17  root     3009: It's very sad to me that the accident which is far from the ideal
1.1.1.13  root     3010: is the first experiences of newcomers.</q>
                   3011: 
                   3012: <li>NetBSD が起動した後なら (正確には powerd(8) が起動していれば)、
                   3013: 終了する時はメニューの「デバイス &gt; 操作 &gt; 電源ボタンを押す」
                   3014: でシャットダウンして電源オフになり、
                   3015: VM の電源オフで nono も終了します。
                   3016: <q>After NetBSD boots up (more precisely, if powerd(8) is running),
                   3017: you can shutdown and power off by
                   3018: "Device &gt; Operation &gt; Push Power button" on menu,
                   3019: and nono will terminate when the VM is powered off.</q>
                   3020: </ul>
                   3021: </div>
1.1.1.14  root     3022: <?php H5end(); ?>
1.1.1.16  root     3023: 
                   3024: 
1.1.1.17  root     3025: <?php H5("", "NetBSD/virt68k をインストールしてみる"
                   3026:        . " <q>Try installing NetBSD/virt68k</q>"); ?>
1.1.1.16  root     3027: <div class="main">
1.1.1.24! root     3028: ここでは NetBSD/virt68k 11.0_RC2 をインストールする手順を紹介します。
        !          3029: <q>Here I will introduce how to install NetBSD/virt68k 11.0_RC2.</q>
1.1.1.16  root     3030: <br>
1.1.1.17  root     3031: <ol>
1.1.1.18  root     3032: 
1.1.1.16  root     3033: <li>どこかに nono 用のディレクトリを用意し(例えば ~/nono/)、
                   3034: その中に VM ディレクトリを用意します (例えば ~/nono/virt68k/)。
                   3035: <q>Create a directory somewhere for nono (for example ~/nono/),
                   3036: and create subdirectories for individual VMs in it
                   3037: (for example ~/nono/virt68k/).</q>
                   3038: 
1.1.1.22  root     3039: <li>NetBSD/virt68k を含む 11.0 は執筆時点ではまだリリースされていませんが、
1.1.1.24! root     3040: 公式サイトに RC (Release Candidate) のイメージが公開されています。
1.1.1.22  root     3041: 以下のリンクから netbsd-GENERIC.gz (カーネル) と
                   3042: inst-ramdisk.fs (インストーライメージ) をダウンロードします。
1.1.1.24! root     3043: <q>As of the time of writing,
        !          3044: NetBSD 11.0 including virt68k has not yet been released.
        !          3045: However, images of RC (Release Candidate) are available on the official site.
        !          3046: Download netbsd-GENERIC.gz (kernel) and inst-ramdisk.fs
        !          3047: (installer image) from the following links.</q>
1.1.1.22  root     3048: <blockquote>
1.1.1.24! root     3049: <a href="https://cdn.netbsd.org/pub/NetBSD/NetBSD-11.0_RC2/virt68k/binary/kernel/netbsd-GENERIC.gz"
        !          3050: >https://cdn.netbsd.org/pub/NetBSD/NetBSD-11.0_RC2/virt68k/binary/kernel/netbsd-GENERIC.gz</a><br>
        !          3051: <a href="https://cdn.netbsd.org/pub/NetBSD/NetBSD-11.0_RC2/virt68k/installation/ramdisks/inst-ramdisk.fs"
        !          3052: u>https://cdn.netbsd.org/pub/NetBSD/NetBSD-11.0_RC2/virt68k/installation/ramdisks/inst-ramdisk.fs</a>
1.1.1.22  root     3053: </blockquote>
1.1.1.18  root     3054: 
1.1.1.16  root     3055: <li>空のディスクイメージを用意します。
                   3056: 1GB でもインストール自体は出来ますが、もう少し大きいほうが安心です。
1.1.1.24! root     3057: (qemu-img がない場合は dd で生イメージを作ります)
1.1.1.16  root     3058: <q>Prepare an empty disk image file.
                   3059: You can install it with 1GB at least,
1.1.1.24! root     3060: but it would be safer if it was a little larger.
        !          3061: (If you doesn't have qemu-img, create a raw image by using dd instead.)</q>
        !          3062: <blockquote class="cons"><pre>
        !          3063: qemu-img create -f qcow2 virt68k.qcow2 2G
        !          3064: </pre></blockquote>
        !          3065: <blockquote>or</blockquote>
1.1.1.16  root     3066: <blockquote class="cons"><pre>
                   3067: dd if=/dev/zero of=virt68k.img bs=1m count=2048
                   3068: </pre></blockquote>
                   3069: 
                   3070: <li>以下の内容の設定ファイル nono.cfg を VM ディレクトリ ~/nono/virt68k
                   3071: に作成します。
                   3072: <q>Create a configuration file nono.cfg in the VM directory, ~/nono/virt68k/,
1.1.1.19  root     3073: with following contents.</q>
1.1.1.16  root     3074: <blockquote class="file"><pre>
1.1.1.17  root     3075: vmtype = virt-m68k
1.1.1.24! root     3076: fast-mode = 1
        !          3077: virtio-block0-image = virt68k.qcow2    # or virt68k.img
1.1.1.18  root     3078: exec-file = netbsd-GENERIC.gz
                   3079: exec-bootparam = root=ld0
1.1.1.16  root     3080: </pre></blockquote>
                   3081: 
1.1.1.24! root     3082: <li>インストーライメージからインストーラを起動します。
        !          3083: 設定ファイルでは運用時のためにルートデバイスを ld0 に指定していますが
        !          3084: インストーラは RAM ディスクから起動したいため <tt>-V</tt>
        !          3085: オプションで <tt>exec-bootparam</tt> を空に戻します。
        !          3086: <q>Run installer from specified installer image.
        !          3087: The configuration file specifies root device as ld0 for normal operation,
        !          3088: but since we want to boot from ramdisk this time,
        !          3089: use the <tt>-V</tt> option to reset <tt>exec-bootparam</tt>.</q>
1.1.1.16  root     3090: <blockquote class="cons"><pre>
1.1.1.24! root     3091: nono -c ~/nono/virt68k --initrd inst-ramdisk.fs -V exec-bootparam=
1.1.1.16  root     3092: </pre></blockquote>
                   3093: 
1.1.1.18  root     3094: <li>しばらくすると見慣れたインストーラが起動してきます。
                   3095: インストールが終わったらトップメニューから e:Utility menu &gt;
                   3096: g:Halt the system
                   3097: を選択してください。ゲストの電源がオフになり nono も終了します。
                   3098: <q>After a while, the familiar installer will start.
                   3099: Once the installation has finished,
1.1.1.23  root     3100: select e:Utility menu &gt; g:Halt the system.
1.1.1.18  root     3101: Then the guest will shut down, and nono also will terminate.</q>
                   3102: 
                   3103: <li>インストールしたディスクから起動するには、
1.1.1.24! root     3104: <tt>--initrd</tt> と <tt>-V</tt> オプションを外して実行します。
1.1.1.18  root     3105: カーネルは引き続きホストファイルシステム上にあるもの
                   3106: (ここでは ~/nono/virt68k/netbsd-GENERIC.gz) を使います。
                   3107: <q>To boot from the installed disk,
1.1.1.24! root     3108: run without <tt>--initrd</tt> and <tt>-V</tt> option.
1.1.1.18  root     3109: It still uses the kernel on the host filesystem,
                   3110: just like the installer does.</q>
1.1.1.16  root     3111: <blockquote class="cons"><pre>
1.1.1.18  root     3112: nono -c ~/nono/virt68k
1.1.1.16  root     3113: </pre></blockquote>
1.1.1.18  root     3114: </ul>
1.1.1.16  root     3115: </div>
                   3116: <?php H5end(); ?>
1.1.1.14  root     3117: <?php H4end(); ?>
1.1       root     3118: 
1.1.1.8   root     3119: 
1.1.1.14  root     3120: <?php H4("network",
                   3121:        "ホストネットワーク設定例 <q>Example of host network setup</q>"); ?>
1.1.1.19  root     3122: <?php H5("network-tap", "tap"); ?>
1.1       root     3123: <div class=main>
1.1.1.19  root     3124: NetBSD の tap(4) デバイスを用いて、
                   3125: ホストの wm0 と nono のゲスト OS を接続する場合の設定例です。
1.1.1.8   root     3126: <ol>
                   3127: <li>
1.1.1.19  root     3128: 設定ファイル nono.cfg に以下の行を追加します。
                   3129: <q>Add the following line to configuration file, nono.cfg.</q>
1.1       root     3130: <blockquote class="file"><pre>
1.1.1.8   root     3131: hostnet-driver = tap
                   3132: hostnet-tap-devpath = auto
1.1       root     3133: </pre></blockquote>
1.1.1.8   root     3134: 
1.1.1.5   root     3135: <li>デフォルトでは /dev/tap は一般ユーザからアクセスできないので、
                   3136: chmod で適当にパーミッションを与えます。
                   3137: 番号の付いていないほうの /dev/tap だけでいいです。
                   3138: sysinst 等で OS をアップグレードするとパーミッションが 600
                   3139: に戻るのがハマりポイントです。
1.1.1.8   root     3140: <q>By default, /dev/tap is only accessible to privileged user.
                   3141: You need to chmod /dev/tap (without unit number) appropriately.
1.1.1.16  root     3142: Note that upgrading using sysinst always resets the permission to 600.</q>
1.1.1.5   root     3143: 
                   3144: <li>bridge(4) インタフェースを作成し、
1.1.1.8   root     3145: ホストの外部(物理)インタフェースをブリッジに追加しておきます。
1.1.1.5   root     3146: <q>Create a bridge(4) interface, and
                   3147: add your physical interface to the bridge.</q>
1.1       root     3148: <blockquote class="cons"><pre>
1.1.1.5   root     3149: # ifconfig bridge0 create
1.1       root     3150: # brconfig bridge0 add wm0
                   3151: </pre></blockquote>
1.1.1.8   root     3152: 常用するなら /etc の設定ファイルに書いておきましょう。
                   3153: <q>If you use it regularly,
1.1.1.5   root     3154: you can put configuration file into /etc.</q>
                   3155: <blockquote>
                   3156: /etc/ifconfig.bridge0
                   3157: <pre class=file>
                   3158: create
                   3159: up
                   3160: !/sbin/brconfig $int add wm0
                   3161: </pre>
                   3162: <pre class=cons>
                   3163: # /etc/rc.d/network restart
                   3164: </pre>
                   3165: </blockquote>
                   3166: 
                   3167: <li>
                   3168: 一般ユーザに戻って、
                   3169: VM ディレクトリかその親ディレクトリに
                   3170: 次のような 2つのスクリプトを用意します。
1.1.1.8   root     3171: nono は tap(4) をオープンし、
                   3172: そのデバイス名を引数にこれらのスクリプトを呼びます。
1.1.1.5   root     3173: sudo の設定は別途行ってください。
                   3174: <q>Return to non-privileged user, and
                   3175: create following two scripts in the VM directory or its parent directory.
1.1.1.8   root     3176: nono will open tap(4) and
                   3177: invoke these scripts with the name of the device as an argument.
1.1.1.5   root     3178: In addition, you need to set up sudo separately.</q>
1.1       root     3179: <blockquote>
                   3180: nono-ifup
                   3181: <pre class=file>
                   3182: #!/bin/sh
1.1.1.5   root     3183: sudo /sbin/ifconfig $1 up
                   3184: sudo /sbin/brconfig bridge0 add $1
1.1       root     3185: </pre></blockquote>
                   3186: 
                   3187: <blockquote>
1.1.1.5   root     3188: nono-ifdown
1.1       root     3189: <pre class=file>
                   3190: #!/bin/sh
1.1.1.5   root     3191: sudo /sbin/brconfig bridge0 delete $1
                   3192: sudo /sbin/ifconfig $1 down
                   3193: </pre></blockquote>
                   3194: 
                   3195: <blockquote class="cons"><pre>
                   3196: % chmod +x nono-ifup nono-ifdown
1.1       root     3197: </pre></blockquote>
                   3198: 
1.1.1.5   root     3199: <li>nono を起動し、
                   3200: メニューの「モニタ &gt; ホスト &gt; ホストネットワーク」を開いて
1.1.1.8   root     3201: HostNet Driver: tap になっていれば動いてるはずです。
1.1.1.5   root     3202: <q>Run nono,
                   3203: and open "Monitor &gt; Host &gt; Host Network" window from menu.
1.1.1.8   root     3204: It's OK if you can see "HostNet Driver: tap".</q>
1.1.1.5   root     3205: 
                   3206: </ol>
1.1       root     3207: </div>
1.1.1.19  root     3208: <?php H5end(); ?>
1.1.1.14  root     3209: <?php H4end(); ?>
                   3210: 
1.1       root     3211: 
1.1.1.14  root     3212: <?php H4("knownissues", "既知の問題 <q>Known Issues</q>"); ?>
1.1.1.12  root     3213: <div class="main">
                   3214: <ul>
1.1.1.13  root     3215: <li>デバッガのコンソール入力で、
1.1.1.14  root     3216: カーソルキーなどの特殊文字入力に対する表示が動作していません。
                   3217: <q>In debugger console, some special characters like cursor keys
1.1.1.12  root     3218: aren't printed correctly.</q>
1.1.1.13  root     3219: (since ver 0.3.0)
1.1.1.12  root     3220: <li>ホストが VirtualBox (on Windows?) で、
                   3221: VirtualBox の「マウス統合」が有効にしている場合、
                   3222: nono の「マウスモード」でマウスポインタが正しく移動しません。
                   3223: <q>If the host OS is running on VirtualBox (on Windows?) and
                   3224: "Mouse integration" on VirtualBox is enabled,
                   3225: the mouse pointer will not move as expected in nono's Mouse Mode.</q>
                   3226: (2021/12/30)
                   3227: 
                   3228: <li>Wayland の場合にウィンドウサイズが正しく設定されない場合があります。
1.1.1.17  root     3229: wxWidgets (3.0/3.2) のバグと思われます。
1.1.1.12  root     3230: <q>On Wayland, window size may be incorrect.
1.1.1.17  root     3231: This may be due to wxWidgets (3.0/3.2) bug.</q>
                   3232: (2021/12/30, Updated 2024/07/03)
                   3233: 
1.1.1.18  root     3234: <li>nono ではありませんが、wxWidgets 3.2 (with GTK3) は
                   3235: NetBSD/sparc (などマイナーアーキテクチャ?)
                   3236: でウィンドウ内がほぼ描画されないようです。
                   3237: wxWidgets 3.0 (with GTK2) であれば動作します。
                   3238: <q>On wxWidgets 3.2 (with GTK3), it seems that the inside of the window
                   3239: is hardly drawn at NetBSD/sparc (and such minor architectures?).
                   3240: wxWidgets 3.0 (with GTK2) can.</q>
1.1.1.17  root     3241: (2024/07/03)
1.1.1.12  root     3242: 
                   3243: </ul>
                   3244: </div>
1.1.1.14  root     3245: <?php H4end(); ?>
                   3246: 
1.1       root     3247: 
1.1.1.14  root     3248: <?php H4("migrate",
                   3249:        "過去のバージョンからの移行方法 <q>How to migrate from old versions</q>");
                   3250: ?>
1.1.1.9   root     3251: <div class="main">
                   3252: バージョンアップに伴い設定ファイル等に非互換が発生する場合があります。
                   3253: その場合は以下の移行方法を参照して設定ファイル等を更新してください。
                   3254: <q>Some versions may have incompatibilities in the configuration files, etc.
                   3255: In such case, you may need to upgrade it by referring the following link.</q>
                   3256: <ul>
1.1.1.23  root     3257: <li><?php linkto("upgrade-1.6.0", "From ver 1.5.0 to ver 1.6.0"); print "\n"; ?>
                   3258: <li><?php linkto("upgrade-1.2.0", "From ver 1.1.x to ver 1.2.0"); print "\n"; ?>
1.1.1.9   root     3259: </ul>
                   3260: </div>
1.1.1.14  root     3261: <?php H4end(); ?>
                   3262: 
1.1.1.2   root     3263: 
1.1.1.17  root     3264: <?php H4("util", "付属ソフトウェア <q>Included Software</q>"); ?>
                   3265: <div class="main">
                   3266: <ul>
1.1.1.23  root     3267: <li><?php linkto("runx", "runx"); print "\n"; ?>
1.1.1.17  root     3268: </ul>
                   3269: </div>
                   3270: <?php H4end(); ?>
                   3271: 
                   3272: 
1.1.1.14  root     3273: <?php H4("changes", "変更履歴 <q>Changes</q>"); ?>
1.1.1.10  root     3274: <div class="main">
1.1.1.23  root     3275: See <?php linkto("changes", "changes.html"); print "\n"; ?>.
1.1.1.10  root     3276: </div>
1.1.1.14  root     3277: <?php H4end(); ?>
                   3278: 
1.1.1.10  root     3279: 
1.1.1.14  root     3280: <?php H4("license", "連絡先、ライセンス等 <q>Contact, License, etc</q>"); ?>
1.1.1.10  root     3281: 
1.1.1.14  root     3282: <?php H5("", "ライセンス <q>License</q>"); ?>
1.1.1.2   root     3283: <div class="main">
1.1.1.14  root     3284: <ul>
                   3285: <li>
                   3286: nono 自身については
                   3287: <a href="nono-license.txt">nono-license.txt</a> を読んでください。
                   3288: <q>See nono-license.txt about nono itself.</q>
                   3289: <li>
                   3290: nono は無償公開されている X68030 の IPLROM を使用しています。
1.1.1.13  root     3291: <a href="fsharp-license.txt">許諾条件</a>を読んでください。
                   3292: <q>nono uses X68030 IPLROM image distributed without charge.
                   3293: You must read
                   3294: <a href="fsharp-license.txt">the license agreement</a>
                   3295: (even though it's Japanese original text only).</q>
1.1.1.14  root     3296: <li>
                   3297: nono は SIL Open Font License version 1.1 で配布されているフォントの
                   3298: 一部を改変して組み込んでいます。
                   3299: <q>nono modifies and embeds the font distributed as SIL Open Font License version 1.1.</q>
                   3300: </ul>
                   3301: </div>
                   3302: 
                   3303: <?php H5end(); ?>
1.1.1.2   root     3304: 
1.1.1.14  root     3305: <?php H5("", "連絡先 <q>Contact us</q>"); ?>
1.1.1.4   root     3306: <div class="main">
                   3307: バグ報告などは以下にお願いします。日本語でおk。
                   3308: <q>If you find any problems, please let me know.
                   3309: You may write in English.</q><br>
                   3310: <a href="https://github.com/isaki68k/nono-issue/issues"
                   3311: >https://github.com/isaki68k/nono-issue/issues</a>
                   3312: </div>
1.1.1.14  root     3313: <?php H5end(); ?>
1.1.1.4   root     3314: 
1.1.1.14  root     3315: <?php H5("", "パッチの提供について <q>About contributes</q>"); ?>
1.1.1.2   root     3316: <div class="main">
                   3317: パッチを提供してくださる場合は以下に同意したものとします。
1.1.1.12  root     3318: <q>If you provide a patch to nono, we assume that you agree the following
1.1.1.11  root     3319: conditions:</q>
1.1.1.2   root     3320: <ul>
                   3321: <li>成果物が nono のライセンスに従って運用あるいは配布されること。
1.1.1.15  root     3322: <q>All your work will be operated or distributed under the nono license.</q>
1.1.1.2   root     3323: <li>ライセンスが将来変わる可能性があること。
                   3324: <q>The license may be changed in the future.</q>
                   3325: <li>著作部分に関して著作者人格権を行使しないこと。
                   3326: <q>Do not exercise your author's rights.</q>
                   3327: </ul>
                   3328: </div>
1.1.1.14  root     3329: <?php H5end(); ?>
1.1.1.2   root     3330: 
1.1.1.14  root     3331: <?php H5("", "Acknowledgements"); ?>
1.1.1.2   root     3332: <div class="main">
                   3333: nono は以下の広告条項を含むソースコードを利用しています。
                   3334: <q>nono uses source code with the following advertising clause.</q>
                   3335: <blockquote>
                   3336: This product includes software developed by Gordon Ross<br>
                   3337: This product includes software developed by the University of California, Lawrence Berkeley Laboratory.<br>
                   3338: </blockquote>
                   3339: </div>
1.1.1.14  root     3340: <?php H5end(); ?>
                   3341: <?php H4end(); ?>
1.1       root     3342: 
                   3343: <hr>
1.1.1.2   root     3344: nono project
1.1       root     3345: </body>
                   3346: </html>

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.