Annotation of nono/doc/index.html, revision 1.1.1.16

1.1.1.2   root        1: <!--
                      2:  nono
                      3:  Copyright (C) 2020 nono project
                      4:  Licensed under nono-license.txt
                      5: -->
1.1       root        6: <html><head>
                      7: <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
                      8: <title>nono document</title>
                      9: <style type="text/css">
                     10: /* https://jfly.uni-koeln.de/colorset/ */
                     11: 
                     12: :root {
                     13:        --blue:                 rgb(  0,  90, 255);
                     14:        --brown:                rgb(128,  64,   0);
                     15:        --green:                rgb(  3, 175, 122);
                     16:        --grey:                 rgb(132, 145, 158);
1.1.1.13  root       17:        --cream:                rgb(255, 255, 128);
                     18:        --yellow-green: rgb(216, 242,  85);
1.1.1.9   root       19:        --light-pink:   rgb(255, 202, 191);
1.1.1.13  root       20:        --light-green:  rgb(119, 217, 168);
1.1       root       21:        --light-grey:   rgb(200, 200, 203);
1.1.1.4   root       22: 
                     23:        --bg-grey:              rgb(220, 220, 223);
1.1       root       24: }
                     25: body {
1.1.1.4   root       26:        background-color: var(--bg-grey);
1.1       root       27: }
                     28: q {
                     29:        color: var(--brown);
                     30: }
                     31: q:before {
                     32:        content: "[";
                     33: }
                     34: q:after {
                     35:        content: "]";
                     36: }
                     37: dt.dt-indent {
                     38:        padding-left: 1ex;
                     39: }
1.1.1.15  root       40: .h4 {
                     41:        font-weight: bold;
                     42:        font-size: 110%;
                     43: }
                     44: .h5 {
                     45:        font-weight: bold;
                     46:        padding-left: 1ex;
                     47: }
1.1       root       48: .main {
1.1.1.15  root       49:        margin-left: 2em;
                     50: }
                     51: .main1 {
1.1       root       52:        margin-left: 1em;
                     53: }
                     54: .cons {
                     55:        background-color: black;
                     56:        color: white;
                     57: }
                     58: .file {
                     59:        background-color: white;
                     60:        color: black;
                     61: }
                     62: .strike {
                     63:        color: var(--grey);
                     64: }
1.1.1.5   root       65: .strike > q {
                     66:        color: var(--grey);
                     67: }
1.1.1.13  root       68: .new {
                     69:        background-color: var(--light-green);
                     70: }
                     71: .new > q {
                     72:        background-color: var(--light-green);
                     73: }
1.1       root       74: </style>
                     75: </head>
                     76: <body>
1.1.1.16! root       77: <h3>nono 0.6.0 (2023/03/22)</h3>
1.1       root       78: 
1.1.1.14  root       79: nono は NetBSD とかで動作する OMRON LUNA-I/LUNA-88K
                     80: (と SHARP X68030) のエミュレータです。
                     81: <q>nono is OMRON LUNA-I/LUNA-88K (and SHARP X68030) emulator
                     82: runs on NetBSD and etc.</q>
1.1.1.9   root       83: 
                     84: <hr>
                     85: 
                     86: <h4>Index of this page:</h4>
1.1.1.8   root       87: <div class="main">
1.1.1.11  root       88: <a href="#build">1. ビルド方法 <q>How to build</q></a><br>
1.1.1.14  root       89: <a href="#execute">2. 実行方法 <q>How to execute</q></a><br>
1.1.1.11  root       90: <a href="#configuration">3. 設定 <q>Configuration</q></a><br>
                     91: <a href="#aboutvm">4. VM について <q>About VM</q></a><br>
                     92: <a href="#tryit">5. 実行してみる <q>Try it</q></a><br>
1.1.1.14  root       93: <a href="#network">6. ホストネットワーク設定例 <q>Example of host network setup</q></a><br>
1.1.1.13  root       94: <a href="#knownissues">7. 既知の問題 <q>Known Issues</q></a><br>
                     95: <a href="#migrate">8. 過去のバージョンからの移行方法
1.1.1.10  root       96: <q>How to migrate from old versions</q></a><br>
1.1.1.13  root       97: <a href="#changes">9. 変更履歴 <q>Changes</q></a><br>
                     98: <a href="#license">10. 連絡先、ライセンス等 <q>Contact, License, etc</q></a><br>
                     99: </div>
                    100: <p>
                    101: <div class="main">
                    102: <span class="new">緑背景</span>は新規または目立った更新のあった箇所です。
                    103: <q><span class="new">Green Background</span> is new or updated paragraph.</q>
1.1.1.8   root      104: </div>
1.1.1.4   root      105: 
1.1.1.13  root      106: 
1.1.1.8   root      107: <a name="build"></a>
1.1.1.15  root      108: <details open style="padding-top: 1em">
                    109: <summary><span class=h4>1. ビルド方法 <q>How to build</q></span></summary><div class="main">
1.1.1.5   root      110: ビルドには以下が必要です。
1.1.1.14  root      111: <q>The followings are required for build.</q>
1.1.1.5   root      112: 
1.1       root      113: <ul>
1.1.1.2   root      114: <li>make (BSD make, not GNU make)
1.1.1.4   root      115: <li>C/C++ compiler which supports -std=c++14.
                    116: <br>
1.1.1.13  root      117: (For gcc, 7.4 or newer works at least.
                    118: For clang, 7.0 - 13.0 works at least.)
                    119: <li>wxWidgets 3.0.x "stable" branch
1.1.1.15  root      120: or 3.2.x "new stable" branch
1.1.1.2   root      121: <li>gettext
1.1       root      122: </ul>
1.1.1.2   root      123: 
1.1.1.5   root      124: <p>
1.1.1.15  root      125: wxWidgets は NetBSD(pkgsrc) なら
                    126: pkgsrc/x11/wxGTK30 (OPTIONS:gtk3 で動作確認) です。
                    127: 2022Q3 の wxGTK32 ではビルドできないようです。
1.1.1.14  root      128: <q>If you use NetBSD(pkgsrc),
1.1.1.15  root      129: wxWidgets is pkgsrc/x11/wxGTK30 (OPTIONS:gtk3 is tested).
                    130: wxGTK32 in 2022Q3 doesn't seem to build for now.</q>
1.1.1.14  root      131: 
                    132: <p>
1.1.1.5   root      133: (NetBSD 以外でのビルドはサポートしていませんが)
1.1.1.10  root      134: Ubuntu 20.04 ではたぶん以下のパッケージが必要です。
1.1.1.11  root      135: <q>You may need the following packages on Ubuntu 20.04
1.1.1.5   root      136: (though we won't support non-NetBSD platform).</q>
                    137: </p>
1.1.1.8   root      138: <ul>
                    139: <li>
1.1.1.5   root      140: bmake
                    141: build-essential
                    142: gettext
                    143: libbsd-dev
                    144: libkqueue-dev
1.1.1.10  root      145: libwxgtk3.0-gtk-dev
1.1.1.5   root      146: zlib1g-dev
1.1.1.8   root      147: </ul>
1.1.1.5   root      148: 
1.1.1.2   root      149: <p>
1.1.1.9   root      150: nono のソースアーカイブを展開したら以下のようにビルドします。
1.1.1.2   root      151: configure には環境変数 CC、CXX でコンパイラを指定することが出来ます。
                    152: また wx-config が標準的な名前で提供されていないために見付けられない場合には
                    153: 環境変数 WX_CONFIG にパスを指定することが出来ます。
1.1.1.9   root      154: <q>Extract the nono's source archive and build as following.
1.1.1.2   root      155: You can specify C/C++ compiler using environment variable CC and CXX
                    156: if configure cannot find standard name suitable compiler.
                    157: Also, you can specify wx-config path using environment variable WX_CONFIG
                    158: if configure cannot find wx-config.</q>
1.1.1.13  root      159: </p><p>
                    160: <tt>-DNOTEST</tt> は開発者用のテストツールをビルドしないためのものです。
                    161: <q>With <tt>-DNOTEST</tt>, the build excludes test tools which is needed
                    162: for developers only.</q>
                    163: 
1.1       root      164: <blockquote class="cons"><pre>
                    165: % ./configure
1.1.1.13  root      166: % make -DNOTEST depend
                    167: % make -DNOTEST
1.1.1.2   root      168: % su
                    169: # make install
1.1       root      170: </pre></blockquote>
1.1.1.2   root      171: 
                    172: <p>
                    173: 2つの実行ファイルがインストールされます。
                    174: <tt>nono</tt> が GUI 版実行ファイル、
                    175: <tt>nono-cli</tt> がコマンドライン版です。
                    176: <q>Two executables will be installed.
1.1.1.8   root      177: <tt>nono</tt> is the GUI executable and <tt>nono-cli</tt> is
                    178: the command line executable.</q>
1.1       root      179: 
                    180: </div>
1.1.1.15  root      181: </details>
1.1       root      182: 
                    183: 
1.1.1.14  root      184: <a name="execute"></a>
1.1.1.15  root      185: <details open style="padding-top: 1em">
                    186: <summary><span class=h4>2. 実行方法 <q>How to execute</q></span></summary><div class="main">
                    187: nono は複数機種に対応しているため設定なしでは起動できません。
                    188: 設定は設定ファイルかコマンドラインオプションで指定します。
1.1.1.16! root      189: nono はまず設定ファイル ~/.nono.cfg
        !           190: があれば読み込み、続いてカレントディレクトリの設定ファイル nono.cfg
        !           191: があれば読みます
1.1.1.15  root      192: (<tt>-c</tt> オプションで設定ファイル (VM ディレクトリ) の位置を指定することも出来ます)。
                    193: 詳細は以下の<a name="#configuration">設定</a>の章を参照してください。
                    194: <q>nono supports multiple architectures so that
                    195: it needs configuration.
1.1.1.16! root      196: First, nono reads a configuration file
        !           197: names ~/.nono.cfg if exists, then
        !           198: reads a configuration file names nono.cfg in the current directory if exists
1.1.1.15  root      199: (You can specify the configuration file path (or VM directory) using
                    200: <tt>-c</tt> option).
                    201: See the following <a name="#configuration">Configuration</a> section for
                    202: details.</q>
1.1.1.14  root      203: </div>
                    204: 
1.1.1.8   root      205: <a name="commandline"></a>
1.1.1.15  root      206: <details open style="padding-top: 1em">
                    207: <summary><span class=h5>2.1. コマンドラインオプション <q>Command Line Option</q></span></summary><div class="main">
1.1       root      208: <dl>
1.1.1.7   root      209: <dt class=dt-indent><tt>-c <i>vmpath</i></tt></dt>
                    210: <dd>VM ディレクトリ/設定ファイルを指定します。
                    211: <i>vmpath</i> がディレクトリならそのディレクトリの中の nono.cfg
                    212: を設定ファイルとします。
                    213: <i>vmpath</i> がファイルならそれを設定ファイルとします。
                    214: そしていずれの場合も
                    215: 設定ファイルがあるディレクトリを VM ディレクトリとします。
                    216: -c オプションを省略すると <i>vmpath</i> をカレントディレクトリとします。
                    217: <q>Specifies the VM directory/configuration file.
                    218: If <i>vmpath</i> is a directory,
                    219: make nono.cfg in that directory a configuration file.
                    220: Or if <i>vmpath</i> is a file,
                    221: make the specified file a configuration file.
                    222: And in both cases,
                    223: make the directory where that file is located a VM directory.
                    224: If <tt>-c</tt> option is omitted,
1.1.1.12  root      225: <i>vmpath</i> is considered as the current directory.</q></p></dd>
1.1.1.16! root      226: <dt class=dt-indent><tt>--create-sram</tt></dt>
        !           227: <dd>(X68030 Only)
1.1.1.15  root      228: VM ディレクトリに X68030 用の SRAM.DAT がなければ初期状態で作成して終了します。
                    229: <q>
                    230: nono will create the initial SRAM.DAT for X68030 and exit,
1.1.1.16! root      231: if there is no SRAM.DAT in the VM directory.</q></p></dd>
1.1       root      232: <dt class=dt-indent><tt>-f</tt></dt>
                    233: <dd>高速モードで起動します。
1.1.1.2   root      234: GUI なら起動後にもメニューから変更できますが、その初期値を変えるだけです。
1.1.1.16! root      235: 設定の <tt>fast-mode=1</tt> と等価です。
1.1.1.2   root      236: <q>Boot as the fast mode.
                    237: You can change this mode on GUI menu after boot,
1.1.1.15  root      238: and the option only changes its initial state.
1.1.1.16! root      239: This option is equivalent to <tt>fast-mode=1</tt> in configuration.</q></p></dd>
1.1       root      240: <dt class=dt-indent><tt>--fontsize <i>height</i></tt></dt>
                    241: <dd>GUI 版のみ。
                    242: 全サブウインドウの起動時のフォントサイズを指定します。
1.1.1.3   root      243: 起動後にメニューから変更できます。
1.1.1.16! root      244: 設定の <tt>monitor-fontsize</tt> と等価です。
1.1.1.15  root      245: <q>GUI Only.
                    246: Specifies the initial fontsize of all sub windows.
                    247: You can change this value on GUI menu after boot.
1.1.1.16! root      248: This option is equivalent to <tt>monitor-fontsize</tt> in configuration.</q></p></dd>
1.1       root      249: <dt class=dt-indent><tt>-s <i>scale</i></tt></dt>
                    250: <dd>GUI 版のみ。
                    251: メインウィンドウの起動時のスケールを実数で指定します。
1.1.1.15  root      252: 設定の <tt>mainview-scale</tt> と等価です。
                    253: 起動後はメニューからプリセットされた倍率と
1.1.1.16! root      254: <tt>mainview-scale</tt> で指定された倍率には変更可能です。
1.1.1.15  root      255: <q>GUI Only.
1.1.1.2   root      256: Specifies the initial main window scale in real number.
1.1.1.16! root      257: This is equivalent to <tt>mainview-scale</tt> in configuration.
1.1.1.15  root      258: You can change this scale on GUI menu after boot.</q></p></dd>
1.1       root      259: <dt class=dt-indent><tt>--show-config</tt></dt>
1.1.1.2   root      260: <dd>設定ファイルと <tt>-V</tt> オプションを読み込んだ結果を表示します。
                    261: <q>Shows the result of reading configuration file and
                    262: parsing <tt>-V</tt> options.</q></p></dd>
1.1       root      263: <dt class=dt-indent><tt>-v</tt></dt>
1.1.1.2   root      264: <dd>バージョンを表示します。
                    265: <q>Shows the version.</q></p></dd>
1.1       root      266: <dt class=dt-indent><tt>-V <i>name</i>=<i>value</i></tt></dt>
1.1.1.3   root      267: <dd>設定ファイルで指定した <tt><i>name</i>=<i>configvalue</i></tt> の代わりに
1.1.1.2   root      268: このオプションの <tt><i>name</i>=<i>value</i></tt> を適用します。
1.1.1.13  root      269: <tt><i>name</i></tt> が正しくない場合はエラー終了します。
1.1.1.3   root      270: <q>Use this <i>name</i>=<i>value</i>
1.1.1.13  root      271: instead of <i>name</i>=<i>configvalue</i> specified in configuration file.
                    272: If <tt><i>name</i></tt> is not correct, it will exit on error.</q></p></dd>
1.1.1.10  root      273: <dt class=dt-indent><tt>-X <i>file</i></tt></dt>
                    274: <dd>ホストの <tt><i>file</i></tt> をロードして実行します。
                    275: <tt><i>file</i></tt> が相対パスの場合カレントディレクトリからのパスになります。
                    276: ファイルが gzip 圧縮されていれば自動的に展開します。
1.1.1.15  root      277: (展開後の) ファイル形式は以下の通りですが、
1.1.1.10  root      278: 実際にはブートローダとカーネル程度しか想定していません。
1.1.1.15  root      279: また、いずれも起動元デバイスが取得できないなどの問題はあるかも知れません。
1.1.1.10  root      280: <q>Loads and executes host's <tt><i>file</i></tt>.
                    281: If <tt><i>file</i></tt> is relative path,
                    282: it is path from the current directory.
                    283: If the file is gzip'd, it is automatically extracted.
1.1.1.15  root      284: The supported file format (after extracting) is the following.
1.1.1.10  root      285: Actually, it only assumes bootloaders or kernels.
1.1.1.15  root      286: And note that it may not obtain some information that where did I boot from,
                    287: for example.</q>
                    288: <ul>
                    289: <li>a.out (OMAGIC) 実行ファイル (おそらくブートローダのみサポート)
                    290: <q>a.out (OMAGIC) executable (It probably supports bootloaders only)</q>
                    291: <li>ELF 実行ファイル
                    292: (おそらくカーネルのみサポート。
                    293: NetBSD の実行ファイルのようであれば、
                    294: カーネルだと思ってシンボルテーブルも読み込みます)
                    295: <q>ELF executable
                    296: (It probably supports the kernel only.
                    297: If the file is assumed to be NetBSD executable,
                    298: it will also load symbol tables as the bootloader does to the kernel.)</q>
                    299: <li>ELF object (Experimental)
                    300: <li>Human68k .x executable (Experimental)
                    301: </ul>
                    302: LUNA では、設定の <tt>prom-image</tt>、<tt>luna-dipsw1</tt> の内容(後述)によらず
                    303: 内蔵の互換 PROM で起動し、直ちにホストファイルを実行します。
                    304: X68030 では、IPLROM 起動の後の起動デバイスに細工がしてあり、
                    305: そこからホストファイルを実行します。
                    306: <q>
                    307: On LUNA,
                    308: regardless of <tt>prom-image</tt> and <tt>luna-dipsw1</tt> configuration
1.1.1.12  root      309: (see below),
1.1.1.15  root      310: the internal emulated PROM loads and executes the host file immediately.
                    311: On X68030,
                    312: nono hacks the boot device after normal boot from IPLROM,
                    313: and loads and executes the host file.</q></p></dd>
1.1       root      314: </dl>
                    315: 
1.1.1.2   root      316: 以下開発用。<q>For developers:</q>
1.1       root      317: <dl>
1.1.1.3   root      318: <dt class=dt-indent><tt>-b <i>hexaddr</i>[,<i>skipcount</i>]</tt></dt>
1.1       root      319: <dd>デバッガのブレークポイントを 16進数で指定します。</dd>
                    320: <dt class=dt-indent><tt>-C</tt></dt>
                    321: <dd>ログをコンソールにも出力します。
                    322: 通常はログウィンドウにだけ出力されます。</dd>
                    323: <dt class=dt-indent><tt>-d</tt></dt>
                    324: <dd>起動時にデバッガプロンプトで停止します。</dd>
                    325: <dt class=dt-indent><tt>-D</tt></dt>
                    326: <dd>コンソールをデバッガとして使用します。
1.1.1.13  root      327: 過去との互換性のために存在していますが、
1.1.1.14  root      328: <tt>-V debugger-driver=stdio</tt> と等価です。</dd>
1.1       root      329: <dt class=dt-indent><tt>-L <i>name1</i>=<i>level1</i>[,<i>name2</i>=<i>level2</i>,...]</tt></dt>
                    330: <dd>ログレベルを指定します。
                    331: カンマで区切って複数指定することも出来ます。
                    332: <tt>-Lhelp</tt> で name の一覧を表示します。</dd>
1.1.1.12  root      333: <dt class=dt-indent><tt>--load-only <i>file</i></tt></dt>
                    334: <dd><tt>-X</tt> オプションと同様ですが、PROM のプロンプトで停止します。</dd>
1.1       root      335: <dt class=dt-indent><tt>-M <i>name</i>[,<i>name2</i>,...]</tt></dt>
                    336: <dd>起動時に表示するモニタウィンドウを指定します。
1.1.1.3   root      337: カンマで区切って複数指定することも出来ます。
                    338: <tt>-Mhelp</tt> で name の一覧を表示します。</dd>
1.1       root      339: </dl>
                    340: </div>
1.1.1.15  root      341: </details>
                    342: </details>
1.1       root      343: 
1.1.1.8   root      344: 
                    345: <a name="configuration"></a>
1.1.1.15  root      346: <details open style="padding-top: 1em">
                    347: <summary><span class=h4>3. 設定 <q>Configuration</q></span></summary><div class="main">
                    348: nono の設定はいずれも以下の順序で適用されます。
                    349: <q>nono's configurations are always applied in the following order.</q>
1.1.1.16! root      350: <ol>
1.1.1.15  root      351: <li>デフォルト値 <q>Default value</q>
                    352: <li>~/.nono.cfg があればその内容
                    353: <q>Contents of ~/.nono.cfg if exists</q>
                    354: <li>VM ディレクトリ内の nono.cfg (または -c で指定したファイル)
                    355: があればその内容
                    356: <q>Contents of nono.cfg in the VM directory (or the file specified by -c option) if exists</q>
                    357: <li>コマンドラインオプション <q>Command line option</q>
                    358: </ol>
                    359: ファイルの書式はどちらも <tt>key = value</tt> 形式で1行1項目ずつです。
1.1       root      360: <tt>key</tt> と <tt>value</tt> の前後の空白は取り除かれます。
                    361: また空行と "<tt>#</tt>" で始まる行は無視します。
1.1.1.13  root      362: 知らないキーは警告を出した上で無視します。
1.1.1.15  root      363: 同じキーが複数回現れた場合、
                    364: 上に列挙した順に後から書いたほうで上書きし、
                    365: 同じファイル内でも同様に後に書いたほうで上書きします。
                    366: コマンドラインオプション <tt>-V</tt> 等はこれをさらに上書きします。
                    367: コマンドラインオプションで同じキーが複数回現れた場合も後に書いたほうが上書きします。
                    368: <q>
                    369: The syntax of both files is <tt>key = value</tt> format, one per line.
1.1.1.2   root      370: White spaces before and after <tt>key</tt> and <tt>value</tt> are ignored.
1.1.1.13  root      371: Blank lines, lines beginning with "<tt>#</tt>" are also ignored.
1.1.1.15  root      372: The lines with unrecognized key are ignored with a warning.
                    373: 
                    374: If the same key appears more than once,
                    375: the latter overwrites the former in the above order.
                    376: If the same key appears in a file,
                    377: the latter overwrites the former in the same manner.
                    378: Then, command line option <tt>-V</tt> etc. overwrites it.
                    379: If the same key appears more than once in the command line option,
                    380: do in the same manner.</q>
                    381: <p>
                    382: <tt>vmtype</tt> を除くすべての設定項目はそれぞれデフォルト値を持っています。
                    383: つまり少なくとも <tt>vmtype</tt> だけは設定ファイルかコマンドラインオプションで指定する必要があります。
                    384: <q>All configuration items except <tt>vmtype</tt> have default value.
                    385: It means, you must specify at least only <tt>vmtype</tt>
                    386: by configuration file or commandline option.</q>
1.1       root      387: <p>
                    388: 設定項目は次の通りです。
1.1.1.2   root      389: <q>The configuration items are:</q>
1.1       root      390: <dl>
                    391: <dt class=dt-indent><tt>vmtype = <i>string</i></tt></dt>
1.1.1.4   root      392: <dd>VM 種別を以下のいずれかから指定します。
                    393: 省略不可です。
                    394: <q>Specifies the VM type from the following.
1.1.1.12  root      395: This field is mandatory.</q>
1.1.1.4   root      396: <table cellspacing=0 cellpadding=0>
                    397: <tr><td>&nbsp;<td><tt>luna</tt>        <td>… LUNA-I
1.1.1.13  root      398: <tr><td><td><tt>luna88k</tt>   <td>… LUNA-88K
1.1.1.15  root      399: <tr><td><td><tt>x68030</tt>            <td>… X68030 (Experimental)
                    400: <tr><td><td><tt>news</tt>              <td>… NWS-1750 (Just a joke)
1.1.1.4   root      401: </table></p></dd>
1.1.1.15  root      402: <dt class=dt-indent><tt>cgrom-image = <i>path</i></tt></dt>
                    403: <dd>(X68030 Only)
1.1.1.14  root      404: X68030 の外部 CGROM イメージファイルのパスを指定します。
                    405: CGROM は 768KB です。
                    406: <i>path</i> がファイル名のみなら VM ディレクトリとその親ディレクトリからこのファイル名を検索します。
                    407: <i>path</i> が相対パスなら VM ディレクトリからの相対パスになります (現在のディレクトリからではありません)。
                    408: 空にすると nono 内蔵の互換 CGROM を使用します。
                    409: デフォルトは空です。
                    410: <q>Specifies the X68030's external CGROM image file path.
                    411: This CGROM is 768KB.
                    412: If the <i>path</i> does not have any path delimiters,
                    413: the VM directory and then its parent directory will be searched.
                    414: If the <i>path</i> is a relative path,
                    415: it will be path from the VM directory, not from the current directory.
                    416: If the <i>path</i> is empty, nono's builtin compatible CGROM will be used.
1.1.1.15  root      417: The default value is empty.</q></p></dd>
1.1.1.9   root      418: <dt class=dt-indent><tt>clock-sync = <i>value</i></tt></dt>
                    419: <dd>仮想マシン内の時刻の同期方法を指定します。
                    420: <tt>real</tt> なら実時間に同期、<tt>virtual</tt> なら仮想時間に同期します。
                    421: デフォルトは <tt>real</tt> です。
                    422: この機能は実験中のため将来予告なく仕様が変更になる可能性があります。
1.1.1.15  root      423: <q>Specifies how to synchronize the time in virtual machine.
1.1.1.9   root      424: If <tt>real</tt>, synchronize with the real time;
                    425: if <tt>virtual</tt>, synchronize with the virtual time.
                    426: The default is <tt>real</tt>.
                    427: This feature is under experimentation and may be changed in the future
1.1.1.12  root      428: without notice.</q></p></dd>
1.1.1.14  root      429: <dt class=dt-indent><tt>debugger-driver = <i>string</i></tt></dt>
                    430: <dd>デバッガのコンソールドライバを指定します。
1.1.1.13  root      431: <tt>stdio</tt>、<tt>tcp</tt>、<tt>none</tt> が選択可能です。
                    432: <tt>stdio</tt> は標準入出力を使用します。
                    433: <tt>tcp</tt> は TCP ポートで TELNET プロトコルで待ち受けます。
                    434: <tt>none</tt> ならホスト側とは一切通信を行いません。
                    435: デフォルトは <tt>none</tt> です。
                    436: <q>Specifies console driver of the debugger.
                    437: <tt>stdio</tt>, <tt>tcp</tt>, and <tt>none</tt> can be specified.
                    438: <tt>stdio</tt> uses the standard input/output.
                    439: <tt>tcp</tt> listens on TCP port using TELNET protocol.
                    440: <tt>none</tt> doesn't make any communication with the host.
1.1.1.14  root      441: The default is <tt>none</tt>.</q></p></dd>
                    442: <dt class=dt-indent><tt>debugger-tcp-port = <i>integer</i></tt></dt>
                    443: <dd>デバッガのコンソールドライバが tcp の時の TCP 待ち受けポート番号を指定します。
1.1.1.15  root      444: <q>Specifies the TCP port number that debugger console driver listens.</q></p></dd>
                    445: <a name="config-dipsw-autoboot"></a><dt class=dt-indent><tt>dipsw-autoboot = <i>yesno</i></tt></dt>
                    446: <dd>(LUNA and NEWS Only)
                    447: 機種に依存せず DIPSW を自動起動に設定するかどうか指定します。
                    448: "<tt>yes</tt>" なら自動起動するように、
                    449: "<tt>no</tt>" なら自動起動しないように DIPSW 設定を上書きします。
                    450: "" (空) なら何もしません。デフォルトは "" です。
                    451: このオプションは <tt>luna-dipsw1</tt> や <tt>news-dipsw</tt>
                    452: の状態が設定ファイルやコマンドラインオプションによって確定した後に
                    453: 該当のスイッチだけを変更します。
                    454: <q>Specifies whether to configure DIPSW to boot automatically,
                    455: regardless of the models.
                    456: "<tt>yes</tt>" overwrites DIPSW, to boot automatically.
                    457: "<tt>no</tt>" overwrites DIPSW, not to boot automatically.
                    458: "" (Empty) does nothing.
                    459: The default value is "".
                    460: This option only changes the appropriate switch(es)
                    461: after the <tt>luna-dipsw1</tt> or <tt>news-dipsw</tt> configuration
                    462: is determined by the configuration file or command line options.</q></p></dd>
                    463: <dt class=dt-indent><tt>dipsw-serial = <i>yesno</i></tt></dt>
                    464: <dd>(LUNA and NEWS Only)
                    465: 機種に依存せず DIPSW をシリアルコンソールを使うかどうか指定します。
                    466: "<tt>yes</tt>" ならシリアルコンソールを使うように、
                    467: "<tt>no</tt>" ならシリアルコンソールを使わないように DIPSW 設定を上書きします。
                    468: "" (空) なら何もしません。デフォルトは "" です。
                    469: <tt>luna-dipsw1</tt> もしくは <tt>news-dipsw</tt> (機種による)
                    470: の状態が設定ファイルやコマンドラインオプションによって確定した後に
                    471: このオプションによって該当のスイッチだけを変更します。
                    472: NEWS でシリアルコンソールを使わないを選択した場合、
                    473: SW1,2,3 は OFF, OFF, ON にセットされ、
                    474: NWB-512 モノクロコンソール(未実装) が選択されます。
                    475: <q>Specifies whether to configure DIPSW to use serial console,
                    476: regardless of the models.
                    477: "<tt>yes</tt>" overwrites DIPSW, to use serial console.
                    478: "<tt>no</tt>" overwrites DIPSW, not to use serial console.
                    479: "" (Empty) does nothing.
                    480: The default value is "".
                    481: This option only changes the appropriate switch(es)
                    482: after the <tt>luna-dipsw1</tt> or <tt>news-dipsw</tt> configuration
                    483: is determined by the configuration file or command line options.
                    484: If you choose not to use serial console on NEWS,
                    485: SW1,2,3 will be set OFF, OFF, ON respectively,
                    486: and NWB-512 monochrome console (not implemented) will be chosen.</q></p></dd>
1.1.1.16! root      487: <dt class=dt-indent><tt>ethernet-macaddr = <i>string</i><br><span class='new'>ethernet<i>N</i>-macaddr = <i>string</i></span><br></tt></dt>
        !           488: <dd><span class="new"><i>N</i> 番目の</span>
1.1.1.14  root      489: イーサネットデバイスの仮想マシン側の MAC アドレスを指定します。
1.1.1.9   root      490: <tt><i>XX</i>:<i>XX</i>:<i>XX</i>:<i>XX</i>:<i>XX</i>:<i>XX</i></tt>
                    491: 形式で指定します。
                    492: <tt>auto</tt> なら自動的に決定します。
1.1.1.16! root      493: デフォルトは <tt>auto</tt> です。
        !           494: <span class="new"><tt>ethernet-macaddr</tt> は <tt>ethernet0-macaddr</tt> の別名です。</span></p></dd>
        !           495: <dt class=dt-indent><tt>extram-size = <i>integer</i></tt></dt>
        !           496: <dd>(X68030 Only)
1.1.1.15  root      497: 拡張メモリのサイズを MB 単位で指定します。
                    498: 今の所以下だけが指定できます。
                    499: <q>Specifies the extended RAM size in MB.
                    500: For now, only the following can be specified.</q>
1.1.1.16! root      501: <ul>
1.1.1.15  root      502: <li><tt>0</tt> … 拡張メモリを使用しません。デフォルトです。
                    503: <q>No extended memory.  It's default.</q>
                    504: <li><tt>16</tt> … TS-6BE16 互換モードで、
                    505: アドレス $0100'0000〜$01ff'ffff の 16MB です。
                    506: <q>TS-6BE16 compatible mode.
                    507: Its address is $0100'0000〜$01ff'ffff and the size is 16MB.</q>
                    508: <li><tt>128/256</tt> … 060turbo 互換モードで、
                    509: アドレス $1000'0000〜$17ff'ffff/$1fff'ffff の 128/256MB です。
                    510: <q>060turbo compatible mode.
                    511: Its address is $1000'0000〜$17ff'ffff/$1fff'ffff and the size is
                    512: 128 or 256MB.</q>
1.1.1.16! root      513: </ul></p></dd>
        !           514: <dt class=dt-indent><tt>fast-mode = <i>integer</i></tt></dt>
        !           515: <dd>起動時の動作モードを指定します。0 なら通常モード、1 なら高速モードです。
1.1.1.15  root      516: デフォルトは 0 です。
1.1.1.16! root      517: コマンドラインオプション <tt>-f</tt> でも高速モードへのみ指定可能です。</p></dd>
1.1.1.15  root      518: <dt class=dt-indent><tt>fd-drive = <i>integer</i></tt></dt>
                    519: <dd>(X68030 Only)
1.1.1.14  root      520: フロッピードライブの数を 0 から 4 で指定します。
                    521: デフォルトは 2 です。
1.1.1.15  root      522: <q>Specifies the number of floppy drives from <tt>0</tt> to <tt>4</tt>.
1.1.1.14  root      523: The default is <tt>2</tt>.</q></p></dd>
1.1.1.15  root      524: <dt class=dt-indent><tt>fd<i>N</i>-image = <i>path</i></tt></dt>
                    525: <dd>(X68030 Only)
1.1.1.14  root      526: フロッピードライブ <i>N</i> に起動時に挿入するディスクイメージを指定します。
                    527: イメージパスが相対パスなら VM ディレクトリからの相対パスになります。
                    528: 起動後はメニューから操作できます。
                    529: デフォルトは空です。
1.1.1.15  root      530: <q>Specifies a diskimage to be inserted to floppy drive <i>N</i> at startup.
1.1.1.14  root      531: If the <i>path</i> is relative path, it is from the VM directory.
                    532: You can also operate them from menu after startup.
                    533: The default is empty.</q></p></dd>
1.1.1.15  root      534: <dt class=dt-indent><tt>fpu-type = <i>value</i></tt></dt>
                    535: <dd>(X68030 Only)
1.1.1.14  root      536: FPU を装着するかどうか指定しています。
                    537: <tt>none</tt> なら FPU を装着しません。
                    538: <tt>68881</tt> なら FPU として 68881 を装着します。
                    539: 現状 68882 はサポートしていません。
                    540: また <tt>none</tt> の代わりに <tt>0</tt>、
                    541: <tt>68881</tt> の代わりに <tt>1</tt> と書くこともできます。
                    542: デフォルトは <tt>68881</tt> です。
                    543: LUNA-I はたぶん 68881 搭載モデルのみのため設定できません。
1.1.1.15  root      544: <q>Specifies whether to install FPU or not.
1.1.1.14  root      545: If <tt>none</tt>, FPU is not installed.
                    546: If <tt>68881</tt>, 68881 FPU is installed.
                    547: 68882 is not supported yet.
                    548: And, <tt>none</tt> can also be written as <tt>0</tt>,
                    549: <tt>68881</tt> can also be written as <tt>1</tt>.
                    550: The default is <tt>68881</tt>.
                    551: This item cannot be specified on LUNA-I
1.1.1.15  root      552: because (probably) all LUNA-I has 68881.</q></p></dd>
1.1.1.13  root      553: <dt class=dt-indent><tt>hostcom-driver = <i>string</i></tt></dt>
                    554: <dd>シリアルポートのホスト側ドライバを指定します。
                    555: <tt>stdio</tt>、<tt>tcp</tt>、<tt>none</tt> が選択可能です。
                    556: <tt>stdio</tt> は標準入出力を使用します。
                    557: <tt>tcp</tt> は TCP ポートで TELNET プロトコルで待ち受けます。
                    558: <tt>none</tt> ならホスト側とは一切通信を行いません。
                    559: デフォルトは <tt>none</tt> です。
                    560: <q>Specifies the host driver of serial port.
                    561: <tt>stdio</tt>, <tt>tcp</tt>, and <tt>none</tt> can be specified.
                    562: <tt>stdio</tt> uses the standard input/output.
                    563: <tt>tcp</tt> listens on TCP port using TELNET protocol.
                    564: <tt>none</tt> doesn't make any communication with the host.
                    565: The default is <tt>none</tt>.</q></p></dd>
                    566: <dt class=dt-indent><tt>hostcom-tcp-port = <i>integer</i></tt></dt>
                    567: <dd>ホストドライバが tcp の時の TCP 待ち受けポート番号を指定します。
1.1.1.15  root      568: <q>Specifies the TCP port number that host driver listens.</q></p></dd>
1.1.1.13  root      569: <dt class=dt-indent><tt>hostcom-fallback = <i>integer</i></tt></dt>
                    570: <dd><tt>hostcom-driver</tt> で指定したドライバが使用可能でなかった時、
                    571: 0 ならプロセスを終了します。1 なら <tt>none</tt> を選択して実行を継続します。
                    572: デフォルトは 0 です。
1.1.1.15  root      573: <q>Specifies the behavior when the driver which is selected by
1.1.1.13  root      574: <tt>hostcom-driver</tt> is unusable;
                    575: terminate the process if 0,
                    576: or continue to run using the <tt>none</tt> driver if 1.
                    577: The default is 0.</q></p></dd>
1.1.1.11  root      578: <dt class=dt-indent><tt>hostkbd-input = <i>string</i></tt></dt>
1.1.1.15  root      579: <dd>(LUNA and X68030 only)
                    580: ホストキーボードの入力モードを指定します。
1.1.1.11  root      581: <tt>char</tt> ならキャラクタ入力モード、
                    582: <tt>jp</tt> なら日本語キーボードモードです。
                    583: デフォルトは <tt>char</tt> です。
                    584: 詳細は <a href="#aboutvm">VM について</a> の章を参照してください。
                    585: <q>Specifies the input mode of the host keyboard.
                    586: <tt>char</tt> means the character mode,
                    587: <tt>jp</tt> means the Japanese keyboard mode.
                    588: The defualt is <tt>char</tt>.
                    589: See <a href="#aboutvm">About VM</a> for details.</q></p></dd>
1.1.1.16! root      590: <dt class=dt-indent><tt><span class='new'>hostnet<i>N</i>-driver = <i>string</i></span></tt></dt>
        !           591: <dd><span class="new"><i>N</i> 番目の</span>
1.1.1.14  root      592: イーサネットデバイスのホスト側ドライバを指定します。
1.1.1.9   root      593: <tt>afpacket</tt>、<tt>bpf</tt>、<tt>tap</tt> のうち
                    594: ホスト OS がサポートしているものと <tt>auto</tt>、<tt>none</tt> が選択可能です。
                    595: <tt>afpacket</tt> は Linux の AF_PACKET ソケットを使用します。
                    596: <tt>bpf</tt> は bpf(4) デバイスを使用します。
                    597: <tt>tap</tt> は tap(4) インタフェースを使用します。
1.1       root      598: <tt>none</tt> ならホスト側とは一切通信を行いません。
1.1.1.9   root      599: <tt>auto</tt> ならホスト OS がサポートしているもののうち
                    600: <tt>tap</tt> → <tt>afpacket</tt> → <tt>bpf</tt> を順に試します。
1.1.1.16! root      601: <span class="new"><tt>hostnet0-driver</tt> のデフォルトは <tt>auto</tt>、
        !           602: <tt>hostnet1-driver</tt> のデフォルトは <tt>none</tt> です。</span>
        !           603: <q>Specifies the host driver of <span class="new"><i>N</i>-th</span>
        !           604: ethernet device.
1.1.1.9   root      605: <tt>afpacket</tt>, <tt>bpf</tt>, and <tt>tap</tt> can be specified
                    606: only if the host OS supports them.
                    607: <tt>auto</tt> and <tt>none</tt> can always be specified.
                    608: <tt>afpacket</tt> uses Linux's AF_PACKET socket,
                    609: <tt>bpf</tt> uses bpf(4) device,
                    610: and <tt>tap</tt> uses tap(4) interface.
                    611: <tt>none</tt> doesn't make any communication with the host.
                    612: If <tt>auto</tt> is specified,
                    613: it tries <tt>tap</tt>, <tt>afpacket</tt>, and <tt>bpf</tt> in that order
                    614: (if the host OS supports them).
1.1.1.16! root      615: <span class="new">The default of <tt>hostnet0-driver</tt> is <tt>auto</tt>,
        !           616: the default of <tt>hostnet1-driver</tt> is <tt>none</tt>.</q></p></dd>
        !           617: <dt class=dt-indent><tt><span class='new'>hostnet<i>N</i>-afpacket-ifname = <i>ifname</i></span></tt></dt>
        !           618: <dd>ホストドライバが afpacket の時にバインドするインタフェースを1つ指定します。
1.1.1.9   root      619: <i>ifname</i> が <tt>auto</tt>
                    620: なら使用可能なインタフェースを1つ自動的に選択します。
                    621: デフォルトは <tt>auto</tt> です。
                    622: なお、このホストドライバではローカルホストとの通信は出来ません。
1.1.1.15  root      623: <q>Specifies an interface name to bind to, when the host driver is afpacket.
1.1.1.9   root      624: If <tt>auto</tt> is specified as <i>ifname</i>,
                    625: it selects an usable interface automatically.
                    626: The default is <tt>auto</tt>.
                    627: Note that this host driver cannot communicate with the localhost.</q></p></dd>
1.1.1.16! root      628: <dt class=dt-indent><tt><span class='new'>hostnet<i>N</i>-bpf-ifname = <i>ifname</i></span></tt></dt>
        !           629: <dd>ホストドライバが bpf の時にバインドするインタフェースを1つ指定します。
1.1.1.9   root      630: <i>ifname</i> が <tt>auto</tt>
                    631: なら使用可能なインタフェースを1つ自動的に選択します。
                    632: デフォルトは <tt>auto</tt> です。
                    633: なお、このホストドライバではローカルホストとの通信は出来ません。
1.1.1.15  root      634: <q>Specifies an interface name to bind to, when the host driver is bpf.
1.1.1.9   root      635: If <tt>auto</tt> is specified as <i>ifname</i>,
                    636: it selects an usable interface automatically.
                    637: The default is <tt>auto</tt>.
                    638: Note that this host driver cannot communicate with the localhost.</q></p></dd>
1.1.1.16! root      639: <dt class=dt-indent><tt><span class='new'>hostnet<i>N</i>-tap-devpath = <i>path</i></span></tt></dt>
        !           640: <dd>ホストドライバが tap の時に使用するデバイスを1つフルパスで指定します。
1.1.1.9   root      641: デフォルトは <tt>auto</tt> で、この場合は自動的にデバイスを選択します。
                    642: この時の探し方はホスト OS によって異なります。
                    643: Linux なら <tt>/dev/net/tun</tt> を指定したのと同じです。
1.1.1.7   root      644: OpenBSD なら <tt>/dev/tap0</tt> から <tt>/dev/tap9</tt> まで
                    645: 順番にオープンできるまで試します。
                    646: NetBSD (と FreeBSD) ならまず <tt>/dev/tap</tt> でクローニングを試み、
                    647: それが失敗すれば <tt>/dev/tap0</tt> から <tt>/dev/tap9</tt> までを
                    648: 順番にオープンできるまで試します。
1.1.1.9   root      649: いずれの場合も VM ディレクトリかその親ディレクトリに
                    650: <tt>nono-ifup</tt>, <tt>nono-ifdown</tt> という名前のシェルスクリプトが必要です。
                    651: 何もすることがない場合でも正常終了する空のシェルスクリプトを用意してください。
                    652: <q>
1.1.1.15  root      653: Specifies a device pathname, when the host driver is tap.
1.1.1.9   root      654: The default is <tt>auto</tt>.
1.1.1.7   root      655: The behavior in this case depends on the host OS.
                    656: On Linux, it's the same as <tt>/dev/net/tun</tt>.
                    657: On OpenBSD, it will try from <tt>/dev/tap0</tt> to <tt>/dev/tap9</tt>
                    658: until successful.
                    659: On NetBSD (and FreeBSD), it will try cloning by <tt>/dev/tap</tt> first.
                    660: If that fails, then try from <tt>/dev/tap0</tt> to <tt>/dev/tap9</tt>
                    661: until successful.
1.1.1.9   root      662: In all cases, you need to prepare two shell script files which names are
                    663: <tt>nono-ifup</tt> and <tt>nono-ifdown</tt> in the VM directory or
                    664: its parent directory.
                    665: Even if you don't have anything to do in these scripts,
1.1.1.12  root      666: you need to prepare empty scripts that will terminate successfully.</q></p></dd>
1.1.1.16! root      667: <dt class=dt-indent><tt><span class='new'>hostnet<i>N</i>-fallback = <i>integer</i></span></tt></dt>
        !           668: <dd><tt>hostnet<i>N</i>-driver</tt> で指定したドライバが使用可能でなかった時、
1.1.1.9   root      669: 0 ならプロセスを終了します。
                    670: 1 なら none を選択して実行を継続します。
                    671: デフォルトは 0 です。
1.1.1.15  root      672: <q>Specifies the behavior when the driver which is selected by
1.1.1.16! root      673: <tt>hostnet<i>N</i>-driver</tt> is unusable;
1.1.1.9   root      674: terminate the process if 0,
                    675: or continue to run using the <tt>none</tt> driver if 1.
                    676: The default is 0.</q></p></dd>
1.1.1.16! root      677: <dt class=dt-indent><tt><span class='new'>hostnet-driver = <i>string</i><br>hostnet-afpacket-ifname = <i>ifname</i><br>hostnet-bpf-ifname = <i>ifname</i><br>hostnet-tap-devpath = <i>path</i><br>hostnet-fallback = <i>integer</i><br></span></tt></dt>
        !           678: <dd><span class="new">それぞれ <tt>hostnet0-*</tt> の別名です。</span></p></dd>
1.1.1.15  root      679: <dt class=dt-indent><tt>iplrom1-image = <i>path</i></tt></dt>
                    680: <dd>(X68030 Only)
1.1.1.14  root      681: X68030 の外部 IPLROM イメージファイルのパスを指定します。
                    682: こちらは 0xfe0000..0xffffff の 128KB の部分で、IPLROM30 と呼ばれているほうです。
                    683: <i>path</i> がファイル名のみなら VM ディレクトリとその親ディレクトリからこのファイル名を検索します。
                    684: <i>path</i> が相対パスなら VM ディレクトリからの相対パスになります (現在のディレクトリからではありません)。
                    685: 空にすると無償配布されている IPLROM30 を使用します。
                    686: デフォルトは空です。
                    687: <q>Specifies the X68030's external IPLROM image file path.
                    688: This one contains 128KB at 0xfe0000..0xffffff and is known as IPLROM30.
                    689: If the <i>path</i> does not have any path delimiters,
                    690: the VM directory and then its parent directory will be searched.
                    691: If the <i>path</i> is a relative path,
                    692: it will be path from the VM directory, not from the current directory.
                    693: If the <i>path</i> is empty, the public released IPLROM30 will be used.
1.1.1.15  root      694: The default value is empty.</q></p></dd>
                    695: <dt class=dt-indent><tt>iplrom2-image = <i>path</i></tt></dt>
                    696: <dd>(X68030 Only)
1.1.1.14  root      697: X68030 の外部 IPLROM イメージファイルのパスを指定します。
                    698: こちらは 0xfc0000..0xfdffff の 128KB の部分で、ROM30 と呼ばれているほうです。
                    699: <i>path</i> がファイル名のみなら VM ディレクトリとその親ディレクトリからこのファイル名を検索します。
                    700: <i>path</i> が相対パスなら VM ディレクトリからの相対パスになります (現在のディレクトリからではありません)。
                    701: 空にすると内蔵 ROM を使用します。
                    702: 内蔵 ROM は NetBSD/x68k が起動する程度の SCSI IOCS のみサポートしています。
                    703: デフォルトは空です。
                    704: <q>Specifies the X68030's external IPLROM image file path.
                    705: This one contains 128KB at 0xfc0000..0xfdffff and is known as ROM30.
                    706: If the <i>path</i> does not have any path delimiters,
                    707: the VM directory and then its parent directory will be searched.
                    708: If the <i>path</i> is a relative path,
                    709: it will be path from the VM directory, not from the current directory.
                    710: If the <i>path</i> is empty, internal emulated ROM will be used.
                    711: The ROM supports only enough SCSI IOCS to boot NetBSD/x68k.
1.1.1.15  root      712: The default value is empty.</q></p></dd>
1.1.1.13  root      713: <dt class=dt-indent><tt>keyboard-connect = <i>integer</i></tt></dt>
1.1.1.15  root      714: <dd>(LUNA and X68030 Only)
                    715: 起動時にキーボードを本体に接続するかどうかを指定します。
1.1.1.13  root      716: 1 なら接続し、0 なら接続しません。デフォルトは 1 です。
                    717: 起動後はメニューから変更可能です。
1.1.1.15  root      718: <q>Specifies whether to connect keyboard on boot.
1.1.1.13  root      719: If 1, it is connected; if 0, it isn't connected.  The default is 1.
                    720: You can change it on GUI menu after boot.</q></p></dd>
1.1.1.10  root      721: <dt class=dt-indent><tt>luna-adjust-misused-epoch = <i>integer</i></tt></dt>
1.1.1.14  root      722: <dd>(LUNA Only)
                    723: LUNA で誤った RTC epoch を採用している OS 向けに RTC
1.1.1.10  root      724: エミュレーションを補正するかどうかを
                    725: 指定します。0 なら補正をしません(実機と同じ動作)、
                    726: 1 なら補正します(現実世界と同じ動作)。
                    727: デフォルトは 1 で、通常 1 のままで使用して問題ありません。
                    728: <q>
                    729: Specifies whether nono corrects RTC emulation for OSes
                    730: that adopts wrong RTC epoch on LUNA.
                    731: 0 means making no correction
                    732: (this is the same behavior as the actual machine).
                    733: 1 means making correction
                    734: (this is the same behavior as the real world).
                    735: The default is 1.  Normally, leave it 1.</q>
                    736: <p>
                    737: LUNA で採用している RTC (MK48T02) は2桁で保持している年の値が
                    738: 4 で割り切れる年をうるう年とする仕様です。
1.1.1.13  root      739: ところが NetBSD/luna68k、OpenBSD/luna88k などはこの
                    740: RTC の年の値を 1970年からの経過年として使用しています。
1.1.1.10  root      741: 例えば1970年はうるう年ではないため 2月28日の翌日は 3月1日ですが、
                    742: MK48T02 的には 00年であるためうるう年と認識し 2月28日の翌日が2月29日になります。
1.1.1.13  root      743: このように、これらの OS を使っている場合実機の
                    744: RTC は4年のうち約2年間、1日ずれた日付を指しているようです。
1.1.1.10  root      745: しかしながら、RTC の時刻は OS 起動時に一度読んだ後は基本的に参照しない上、
                    746: 今時必要なら NTP で時間を合わせるため、
                    747: 実機でも問題が顕在化することはまずないと思います。
                    748: nono の場合は実機と異なり、アプリケーション実行中しか RTC が進まないため、
                    749: 補正がない場合の動作が問題になるのは
                    750: nono を起動したまま偶数年の2月末日から日付をまたいで、
                    751: かつ nono を起動したまま OS を再起動して NTP などで時刻修正を行わなかった時
                    752: だけだと思います。
                    753: このオプションはほぼ開発者向けの動作確認用です。</p></dd>
1.1       root      754: <dt class=dt-indent><tt>luna-dipsw1 = <i>string</i></tt></dt>
1.1.1.14  root      755: <dd>(LUNA Only)
                    756: 本体前面 DIPSW#1-1..#1-8 の内容を指定します。
1.1       root      757: "<tt>0</tt>" を DOWN、"<tt>1</tt>" を UP として、
                    758: これを8つ並べた形式で、前から順に #1..#8 に対応します。
1.1.1.15  root      759: <q>Specifies status of the front panel DIPSW#1-1..#1-8 using 8 digits.
1.1.1.2   root      760: "<tt>0</tt>" means DOWN and "<tt>1</tt>" means UP.
                    761: The first character corresponds to #1 and
1.1.1.3   root      762: the eighth character corresponds to #8.</q>
                    763: <p>
                    764: LUNA-I でのデフォルトは <tt>11110111</tt> です。
                    765: 各スイッチの内容は以下のリンクを参照してください。
                    766: <q>On LUNA-I, the default value is <tt>11110111</tt>.
1.1.1.4   root      767: See the following link about DIPSW.</q><br>
1.1.1.3   root      768: → <a href="https://wiki.netbsd.org/ports/luna68k/luna68k_info/"
                    769: >NetBSD/luna68k: Information</a>
1.1       root      770: <br>
1.1.1.13  root      771: LUNA-88K でのデフォルトは <tt>11111111</tt> です。
1.1.1.4   root      772: 各スイッチの内容は以下のリンクを参照してください。
1.1.1.13  root      773: <q>On LUNA-88K, the default value is <tt>11111111</tt>.
1.1.1.4   root      774: See the following link about DIPSW.</q><br>
                    775: → <a href="http://man.openbsd.org/boot_luna88k.8"
1.1.1.15  root      776: >OpenBSD manual pages: boot_luna88k(8)</a>
                    777: <p>
                    778: 自動起動するかどうかとシリアルコンソールを使うかどうかを指定したい場合は
                    779: こちらではなく
                    780: <a href="#config-dipsw-autoboot">dipsw-autoboot、dipsw-serial</a>
                    781: 設定を使うほうが便利です。
                    782: <q>If you only want to specify whether to autoboot and/or
                    783: to use serial console,
                    784: <a href="#config-dipsw-autoboot">dipsw-autoboot, dipsw-serial</a>
                    785: configurations are useful.</q></p></dd>
1.1       root      786: <dt class=dt-indent><tt>luna-dipsw2 = <i>string</i></tt></dt>
1.1.1.14  root      787: <dd>(LUNA Only)
                    788: 本体前面 DIPSW#2-1..#2-8 の内容を指定します。
1.1       root      789: 書式は <tt>luna-dipsw1</tt> と同じです。
                    790: デフォルトは <tt>11111111</tt> です。
1.1.1.2   root      791: <q>Specifies status of the front panel DIPSW#2-1..#2-8.
                    792: The same syntax as <tt>luna-dipsw1</tt> is used.
                    793: The default value is <tt>11111111</tt>.</q>
1.1.1.3   root      794: <p>
1.1.1.4   root      795: NetBSD/luna68k のブートローダは、
                    796: DIPSW#2 が "<tt>11111111</tt>" なら自動的にカーネルをロードして実行し、
                    797: どれかでも "<tt>0</tt>" にするとプロンプトで停止するようです。
1.1.1.2   root      798: <span class=strike>(本当は #8 だけで制御するつもりだったんじゃないかという気がします)</span>
1.1.1.4   root      799: <q>NetBSD/luna68k bootloader will automatically load and execute the kernel,
                    800: if the DIPSW#2 is "<tt>11111111</tt>".
1.1.1.2   root      801: Otherwise, the bootloader will enter interactive mode.
                    802: <span class=strike>(I doubt that they actually wanted to switch with only #8)
1.1.1.12  root      803: </span></q></p></dd>
1.1.1.13  root      804: <dt class=dt-indent><tt>luna-video-plane = <i>integer</i></tt></dt>
1.1.1.14  root      805: <dd>(LUNA Only)
1.1.1.15  root      806: LUNA のビデオボードのプレーン数を 1、4、8 から指定します。
1.1.1.13  root      807: 1 ならモノクロビデオボード、
1.1.1.15  root      808: 4 なら16色 (4bpp) ビデオボード、
                    809: 8 なら 256色 (8bpp) ビデオボードです。
1.1.1.16! root      810: デフォルトは 4 です。
1.1.1.15  root      811: <q>Specifies number of planes on LUNA video board.
                    812: The valid values are 1, 4 or 8.
1.1.1.13  root      813: 1 means a monochrome video board,
1.1.1.15  root      814: 4 means 16-color (4bpp) video board,
                    815: 8 means 256-color (8bpp) video board.
1.1.1.16! root      816: The default value is 4.</q></p></dd>
        !           817: <dt class=dt-indent><tt>mainview-scale = <i>double</i></tt></dt>
        !           818: <dd>メインウィンドウの起動時のスケールを実数で指定します。
1.1.1.15  root      819: コマンドラインオプション <tt>-s</tt> で上書き可能です。
                    820: 起動後はメニューから、
                    821: プリセットされた倍率とここで指定した倍率には変更可能です。
1.1.1.16! root      822: デフォルトは 1.0 です。</p></dd>
        !           823: <dt class=dt-indent><tt>monitor-fontsize = <i>integer</i></tt></dt>
        !           824: <dd>テキスト系モニタとステータスパネルのフォントサイズを
1.1.1.15  root      825: 12, 16, 24 から指定します。
                    826: コマンドラインオプション <tt>--fontsize</tt> で上書き可能です。
                    827: 起動後はメニューから変更することができます。
1.1.1.16! root      828: デフォルトは 12 です。</p></dd>
1.1.1.3   root      829: <dt class=dt-indent><tt>monitor-rate = <i>integer</i></tt></dt>
                    830: <dd>テキスト系モニタウィンドウの更新頻度を Hz 単位で指定します。
                    831: 1 から 60 までの間で指定でき、デフォルトは 20Hz です。
1.1.1.16! root      832: 起動後にメニューから、
        !           833: プリセットされた頻度とここで指定した頻度には変更可能です。
1.1.1.3   root      834: <q>Specifies refresh rate of all text monitor windows in Hz.
                    835: It ranges from 1 to 60.  The default is 20Hz.
1.1.1.15  root      836: You can choose this value on GUI menu after boot,
1.1.1.16! root      837: from preset rate or rate specified here.</q></p></dd>
1.1       root      838: <dt class=dt-indent><tt>mpu-clock = <i>value</i></tt></dt>
                    839: <dd>MPU のクロック数を MHz 単位で指定します。
1.1.1.15  root      840: デフォルトは LUNA-I なら 20MHz、LUNA-88K と X68030 なら 25MHz です。
1.1.1.5   root      841: <q>Specifies the MPU clock in MHz.
1.1.1.15  root      842: The default value is 20MHz on LUNA-I, or 25MHz on LUNA-88K and X68030.</q></p></dd>
1.1.1.9   root      843: <dt class=dt-indent><tt>mpu-pseudo-stop = <i>integer</i></tt></dt>
1.1.1.14  root      844: <dd>(LUNA-88K Only)
                    845: m88100 にて疑似 STOP 状態を有効にするかどうかを指定します。
1.1.1.9   root      846: 0 なら無効(実機と同じ動作)、1 なら有効で、デフォルトは 1 です。
                    847: m88100 には、m68k の STOP 命令 (割り込みが上がるまで何もせず待つ)
                    848: に相当する命令がなく、
                    849: 大抵ビジーウェイトループで割り込みが上がるのを待つことになります。
                    850: これは実機では (消費電力を減らす手段がないという些細な問題以外には)
                    851: 何のデメリットもないのですが、
                    852: エミュレータで特に高速動作させている時には割り込みが上がるまで
                    853: (例えば人間がキーを入力するまで) ホスト CPU パワーを使い潰してビジーウェイトループを実行し続けることになり、ホスト CPU があっつあつになります。
                    854: それを防ぐための機能です。
                    855: 特徴的な命令列を検出して実現しているので、すべての状況で動作するわけではありません。</p></dd>
1.1.1.16! root      856: <dt class=dt-indent><tt><span class='new'>nereid0-enable = <i>integer</i><br>nereid1-enable = <i>integer</i><br></span></tt></dt>
        !           857: <dd><span class="new">
        !           858: (X68030 Only)
        !           859: Nereid 拡張ボードを装着するかどうかを指定します。
        !           860: Nereid は同時に2枚まで使用することができます。
        !           861: 値は <tt>0</tt> なら装着せず、<tt>1</tt> なら装着します。
        !           862: デフォルトは <tt>0</tt> (装着しない) です。
        !           863: 詳細は <a href="#nereid">4.5 Nereid の章</a>を参照してください。
        !           864: <q>Specifies whether install Nereid expansion board or not.
        !           865: Up to two board can be operated at the same time.
        !           866: If <tt>0</tt>, the board is not installed.
        !           867: If <tt>1</tt>, the board is installed.
        !           868: The default value is <tt>0</tt>.
        !           869: See also <a href="#nereid">Section 4.5 Nereid</a> below for details.</q>
        !           870: </span></p></dd>
        !           871: <dt class=dt-indent><tt><span class='new'>nereid0-net = <i>integer</i><br>nereid1-net = <i>integer</i><br></span></tt></dt>
        !           872: <dd><span class="new">
        !           873: (X68030 Only)
        !           874: Nereid ボードの NIC (RTL8019AS) のみを無効にすることが出来ます
        !           875: (実機では通常そのようなことは出来ません)。
        !           876: <tt>0</tt> なら無効、<tt>1</tt> なら有効です。デフォルトは <tt>1</tt> です。
        !           877: 通常は <tt>1</tt> のまま使用してください。
        !           878: この設定は対応する <tt>nereid<i>N</i>-enable</tt> が <tt>0</tt>
        !           879: (ボードを装着しない) の場合は意味を持ちません。
        !           880: <q>This can disable only NIC (RTL8019AS) of Nereid expansion board
        !           881: (although it's not possible normally in the real world).
        !           882: It's disabled if <tt>0</tt>, or enabled if <tt>1</tt>.
        !           883: The default is <tt>1</tt>.  Normally, leave it <tt>1</tt>.
        !           884: This item will be ignored if the corresponding <tt>nereid<i>N</i>-enable</tt>
        !           885: is <tt>0</tt>.</q>
        !           886: </span></p></dd>
        !           887: <dt class=dt-indent><tt><span class='new'>nereid0-ram-size = <i>integer</i><br>nereid1-ram-size = <i>integer</i><br></span></tt></dt>
        !           888: <dd><span class="new">
        !           889: (X68030 Only)
        !           890: Nereid ボードのバンクメモリのサイズを MB 単位で指定します。
        !           891: 指定できるのは <tt>0</tt>, <tt>4</tt>, <tt>16</tt> です。
        !           892: <tt>0</tt> を指定するとバンクメモリを無効にします。
        !           893: デフォルトは <tt>16</tt> です。
        !           894: この設定は対応する <tt>nereid<i>N</i>-enable</tt> が <tt>0</tt>
        !           895: (ボードを装着しない) の場合は意味を持ちません。
        !           896: <q>Specifies bank memory size in MB of Nereid expansion board.
        !           897: The valid values are <tt>0</tt>, <tt>4</tt> or <tt>16</tt>.
        !           898: If <tt>0</tt>, disable the bank memory.
        !           899: The default is <tt>16</tt>.
        !           900: This item will be ignored if the corresponding <tt>nereid<i>N</i>-enable</tt>
        !           901: is <tt>0</tt>.</q>
        !           902: <br><br>
        !           903: また通常は必要ありませんが -4 または -16 を指定すると、
        !           904: バンクメモリは無効にした上で Nereid 制御ポートのビット6の読み出し値
        !           905: (バンクメモリの容量) を再現することが出来ます。
        !           906: -4 ならビット6は 0 (4MB)、0 か -16 なら 1(16MB) が読み出せます。
        !           907: </span></p></dd>
1.1.1.15  root      908: <dt class=dt-indent><tt>news-dipsw = <i>string</i></tt></dt>
                    909: <dd>(NEWS Only)
                    910: DIPSW の内容を指定します。
                    911: "<tt>0</tt>" を OFF、"<tt>1</tt>" を ON として、
                    912: これを8つ並べた形式で、前から順に SW1..SW8 に対応します。
                    913: デフォルトは <tt>00001000</tt> です。
                    914: <q>Specifies status of the DIPSW using 8 digits.
                    915: "<tt>0</tt>" means OFF and "<tt>1</tt>" is ON.
                    916: The first character corresponds to SW1 and
                    917: the eighth character corresponds to SW8.
                    918: The default valus is <tt>00001000</tt>.</q>
                    919: <br><br>
                    920: 各スイッチの内容は以下のリンクを参照してください。
                    921: <q>See the following link about DIPSW.</q><br>
                    922: → <a href="https://www.netbsd.org/ports/news68k/faq.html#dip_sw"
                    923: >NetBSD/news68k Frequently Asked Questions</a>
                    924: <p>
                    925: 自動起動するかどうかとシリアルコンソールを使うかどうかを指定したい場合は
                    926: こちらではなく
                    927: <a href="#config-dipsw-autoboot">dipsw-autoboot、dipsw-serial</a>
                    928: 設定を使うほうが便利です。
                    929: <q>If you only want to specify whether to autoboot and/or
                    930: to use serial console,
                    931: <a href="#config-dipsw-autoboot">dipsw-autoboot, dipsw-serial</a>
                    932: configurations are useful.</q></p></dd>
1.1.1.2   root      933: <dt class=dt-indent><tt>prom-image = <i>path</i></tt></dt>
1.1.1.14  root      934: <dd>(LUNA Only)
                    935: LUNA-I/LUNA-88K の外部 ROM イメージファイルのパスを指定します。
1.1.1.2   root      936: <i>path</i> がファイル名のみなら VM ディレクトリとその親ディレクトリからこのファイル名を検索します。
                    937: <i>path</i> が相対パスなら VM ディレクトリからの相対パスになります (現在のディレクトリからではありません)。
                    938: 空にすると内蔵 ROM を使用します。
                    939: デフォルトは空です。
1.1.1.13  root      940: <q>Specifies the LUNA-I/LUNA-88K's external ROM image file path.
1.1.1.2   root      941: If the <i>path</i> does not have any path delimiters,
                    942: the VM directory and then its parent directory will be searched.
                    943: If the <i>path</i> is a relative path,
1.1.1.14  root      944: it will be path from the VM directory, not from the current directory.
1.1.1.2   root      945: If the <i>path</i> is empty, internal emulated ROM will be used.
                    946: The default value is empty.</q>
1.1       root      947: <p>
1.1.1.2   root      948: 実機を持っていない場合はこの値を空に (= デフォルトのままに) しておくと、
1.1.1.9   root      949: nono 内蔵のなんちゃって下位互換 ROM で起動します。
1.1.1.2   root      950: <q>If you does not have the real LUNA machines,
                    951: you can boot with nono's internal downward compatible emulated ROM
1.1.1.12  root      952: if you set this field empty (or leave it as the default).</q>
1.1       root      953: <p>
1.1.1.4   root      954: LUNA-I 実機を持っている場合は
                    955: ROM ファイルを指定することで実機 ROM で起動できます。
1.1.1.2   root      956: ROM ファイルは実機の 0x41000000-0x4101ffff (128KB) を保存したものです。
1.1.1.3   root      957: 今のところ ROM は V4.22 (Thu Jul 27 11:45:42 1989) のみサポートしています。
                    958: それ以外については何も分かりません。
1.1.1.4   root      959: <q>If you have the real LUNA-I machine,
1.1.1.2   root      960: you can boot with the real ROM spcifying the ROM file path.
1.1.1.4   root      961: The ROM file is extracted from 0x41000000-0x4101ffff (128KB) of
                    962: the real LUNA-I machine.
1.1.1.3   root      963: For now, only V4.22 (Thu Jul 27 11:45:42 1989) is supported.
1.1.1.12  root      964: I have no idea about other ROMs.</q>
1.1.1.4   root      965: <p>
1.1.1.13  root      966: LUNA-88K 実機の場合は 0x41000000-0x4103ffff (256KB) を保存したものです。
1.1.1.9   root      967: 今のところ ROM は version 1.20 のみサポートしています。
1.1.1.4   root      968: <q>
1.1.1.13  root      969: For LUNA-88K,
1.1.1.4   root      970: the ROM file is extracted from 0x41000000-0x4103ffff (256KB).
1.1.1.12  root      971: For now, only version 1.20 is supported.</q></p></dd>
1.1.1.3   root      972: <dt class=dt-indent><tt>ram-size = <i>integer</i></tt></dt>
1.1.1.14  root      973: <dd>搭載する RAM サイズを MB 単位で指定します。<q>Specifies the RAM size in MB.</q>
                    974: <ul>
                    975: <li>LUNA-I のデフォルトは 16MB です。
1.1.1.7   root      976: 16MB 未満は 4MB 単位で、
                    977: 16MB 以上は 255MB まで 1MB 単位で指定できます
                    978: (ちなみに NetBSD/luna68k の起動には最低でも 8MB 必要です)。
1.1.1.14  root      979: <q>On LUNA-I, the default is 16MB.
1.1.1.7   root      980: If the size is less than 16MB, you can specify in 4MB unit.
                    981: If larger, you can specify up to 255MB in 1MB unit.
1.1.1.14  root      982: By the way, NetBSD/luna68k needs at least 8MB to boot.</q>
                    983: <li>LUNA-88K のデフォルトは 64MB です。
                    984: 64MB 未満は 16MB 単位で、
                    985: 64MB 以上は暫定で 255MB まで 1MB 単位で指定できます。
                    986: <q>On LUNA-88K, the default is 64MB.
1.1.1.7   root      987: If the size is less than 64MB, you can specify in 16MB unit.
1.1.1.14  root      988: If larger, you can specify up to tentative 255MB in 1MB unit.</q>
1.1.1.15  root      989: <li>X68030 ではメイン RAM 容量を示し、デフォルトは 12MB です。
1.1.1.14  root      990: 4MB から 12MB まで 1MB 単位で指定できます。
1.1.1.16! root      991: 拡張メモリについては extram-size を参照してください。
1.1.1.15  root      992: <q>On X68030, the default is 12MB.
                    993: You can specify it in 1MB unit from 4MB to 12MB.
1.1.1.16! root      994: See extram-size for extended memory.</q>
1.1.1.15  root      995: <li>NWS-1750 では現状 16MB で変更できません。
                    996: <q>On NWS-1750, This is 16MB fixed for now.</q>
1.1.1.14  root      997: </ul></p></dd>
1.1.1.13  root      998: <dt class=dt-indent><tt>rtc-epoch-year = <i>integer</i></tt></dt>
1.1.1.14  root      999: <dd>(LUNA Only)
                   1000: RTC (MK48T02) の基準年を指定します。
1.1.1.13  root     1001: デフォルトは 1970年です。
                   1002: NetBSD/luna68k、OpenBSD/luna88k はいずれも基準年を 1970年としていますので、
                   1003: デフォルトのままで構いません。
                   1004: ゲスト OS に 4.4BSD を使用する際は 1900 を指定します。
1.1.1.15  root     1005: NEWS では今の所 1900 固定で変更出来ません。
1.1.1.14  root     1006: <q>Specifies the RTC (MK48T02) epoch year.
1.1.1.13  root     1007: The default is 1970.
                   1008: Since both NetBSD/luna68k and OpenBSD/luna88k use 1970 as epoch year,
                   1009: there is no need to touch this value.
1.1.1.15  root     1010: If you boot 4.4BSD on LUNA-I as the guest OS, specify 1900.
                   1011: On NEWS, it is fixed at 1900.</q></p></dd>
1.1.1.8   root     1012: <dt class=dt-indent><tt>show-statuspanel = <i>integer</i></tt></dt>
                   1013: <dd>ステータスパネルを表示するかどうかを指定します。
                   1014: 0 なら非表示、1 なら表示です。
1.1.1.15  root     1015: デフォルトは 1(表示) です。
1.1.1.8   root     1016: 起動後はメニューから変更可能です。
                   1017: <q>Specifies whether to display the status panel or not.
                   1018: If 0, it is hidden; if 1, it is shown.
1.1.1.15  root     1019: The default is 1 (show).
1.1.1.12  root     1020: You can change it on GUI menu after boot.</q></p></dd>
1.1.1.10  root     1021: <dt class=dt-indent><tt>spc0-id<i>N</i>-image = <i>devtype</i>[,<i>path</i>]</tt></dt>
1.1.1.15  root     1022: <dd>(LUNA and X68030 Only)
                   1023: SCSI デバイスとイメージを指定します。キーの <i>N</i> には 0 から 7 が入ります。
1.1.1.10  root     1024: ただし ID 7 は本体が使用しますので指定しないでください。
                   1025: 値はデバイス種別 <i>devtype</i> とディスクイメージパス <i>path</i>
                   1026: を "<tt>,</tt>"(カンマ) で区切って並べた形式です。
                   1027: デバイス種別 <i>devtype</i> は以下のいずれかです。
1.1.1.2   root     1028: <q>
1.1.1.10  root     1029: Specifies SCSI device and image.  <i>N</i> in the key is 0 to 7.
1.1.1.2   root     1030: But don't specify ID 7 because the host uses it.
                   1031: The value is in a form of device type <i>devtype</i> and
1.1.1.10  root     1032: the disk image path <i>path</i> separated by "<tt>,</tt>"(comma).
1.1.1.12  root     1033: <i>devtype</i> can be one of the following:</q>
1.1.1.10  root     1034: <ul>
                   1035: <li><tt>hd</tt> … HD drive
                   1036: <li><tt>cd</tt> … CD-ROM drive
                   1037: <li><tt>mo</tt> … MO drive
                   1038: </ul>
                   1039: 
                   1040: <p>
                   1041: <i>devtype</i> が <tt>hd</tt> なら <i>path</i> は省略できません。
                   1042: <i>devtype</i> が <tt>cd</tt> か <tt>mo</tt> なら <i>path</i> は省略可能です。
                   1043: イメージパスが相対パスなら VM ディレクトリからの相対パスになります。
                   1044: <q>
                   1045: If <i>devtype</i> is <tt>hd</tt>, <i>path</i> cannot be ommitted.
                   1046: If <i>devtype</i> is <tt>cd</tt> or <tt>mo</tt>, <i>path</i> can be ommitted.
1.1.1.12  root     1047: If the <i>path</i> is relative path, it is from the VM directory.</q>
1.1.1.2   root     1048: 
1.1       root     1049: <p>
1.1.1.10  root     1050: 例えば、nono.cfg と同じディレクトリに置いた sd0.img を
                   1051: 起動 HDD ディスクイメージとして使い
                   1052: (LUNA では通常 ID 6 をプライマリ HDD に割り当てます)、
                   1053: ID 5 に同じディレクトリの install.iso をセットした CD ドライブを、
                   1054: ID 4 に起動時メディアなしの MO ドライブを接続する場合は次のようになります。
                   1055: <q>For example, if you use a harddisk image sd0.img placed in the same
                   1056: directory as nono.cfg
                   1057: (LUNA usually assigns ID 6 to the primary HDD),
                   1058: ID 5 for CD-ROM drive that loads install.iso in the same directory,
                   1059: and ID 4 for MO drive without media on boot,
1.1.1.2   root     1060: write as following:</q>
1.1       root     1061: <blockquote><pre>
1.1.1.10  root     1062: spc0-id6-image = hd,sd0.img
                   1063: spc0-id5-image = cd,install.iso
                   1064: spc0-id4-image = mo
1.1       root     1065: </pre></blockquote></p></dd>
1.1.1.4   root     1066: <dt class=dt-indent><tt>spc0-id<i>N</i>-seektime = <i>integer</i></tt></dt>
1.1.1.15  root     1067: <dd>(LUNA and X68030 Only)
                   1068: 指定の SCSI HDD の平均シークタイムを msec 単位で指定します。
1.1.1.4   root     1069: 現在のデフォルトは <tt>0</tt> です (S・S・D!! S・S・D!!)。
                   1070: 16 程度を指定すると幾分往時に思いを馳せることが出来るかもしれませんが、
                   1071: 今の所あまり安定していません。
                   1072: <q>Specifies the average seek time of specified SCSI HDD in msec.
                   1073: Currently, the default value is <tt>0</tt>
                   1074: (This may be something like SSD :-).
                   1075: If you specify about 16 or so, you can feel nostalgic,
1.1.1.12  root     1076: but this feature is still unstable.</q></p></dd>
1.1.1.10  root     1077: <dt class=dt-indent><tt>spc0-id<i>N</i>-writeignore = <i>integer</i></tt></dt>
1.1.1.15  root     1078: <dd>(LUNA and X68030 Only)
                   1079: 指定の SCSI HD デバイスへの書き込みをイメージに書き戻すかどうか指定します。
1.1       root     1080: <tt>0</tt> なら通常動作(書き込みを行う)です。
1.1.1.15  root     1081: <tt>1</tt> ならディスクイメージに一切書き戻しません。
                   1082: デバイスへ書き込んだはずのデータは Copy-On-Write の要領で、
                   1083: VM ディレクトリ内の一時ファイルに書き込みます。
                   1084: この一時ファイルはアプリケーション終了時に削除します。
1.1       root     1085: fsck を気にせずカーネルのデバッグとかを行いたい場合にはどうぞ。
                   1086: 何が起きるか意味が分からない人は指定しないでください。
1.1.1.2   root     1087: デフォルトは <tt>0</tt> です。
1.1.1.15  root     1088: <q>Specifies whether nono writes a writing to SCSI HD devices back
                   1089: to the diskimage.
                   1090: <tt>0</tt> means normal operation (writes to the diskimage).
                   1091: <tt>1</tt> means that nono will not write to the diskimage back.
                   1092: Data that the guest wrote to the device will be written to a temporary file
                   1093: in the VM directory,
                   1094: like Copy-On-Write.
                   1095: The temporary file will be removed when the application exits.
1.1.1.2   root     1096: This is useful for kernel debugging because it does not require fsck
1.1.1.15  root     1097: after the kernel hangs or reboots.
                   1098: Don't use this flag if you don't understand this paragraph.
1.1.1.10  root     1099: The default value is <tt>0</tt>.</q>
                   1100: <p>
                   1101: ちなみに、メディアを書き込み禁止にしたい場合はこれではなく、
                   1102: イメージファイルの書き込み権を落としてください。
                   1103: <q>By the way, if you want to make the media write-protected,
                   1104: clear the write permission from the image file
                   1105: (instead of this setting).</q></p></dd>
                   1106: <dt class=dt-indent><tt>spc0-id<i>N</i>-writeprotect = <i>integer</i></tt></dt>
1.1.1.15  root     1107: <dd>(LUNA and X68030 Only)
                   1108: 古いオプションです。
1.1.1.10  root     1109: 代わりに <tt>spc0-id<i>N</i>-writeignore</tt> を使ってください。
                   1110: このオプションは開発用です。
                   1111: <q>Obsolete.
                   1112: Use <tt>spc0-id<i>N</i>-writeignore</tt> instead.
1.1.1.12  root     1113: This option is for developers.</q></p></dd>
1.1.1.15  root     1114: <dt class=dt-indent><tt>sram-sync-ramsize = <i>integer</i></tt></dt>
                   1115: <dd>(X68030 Only)
1.1.1.14  root     1116: SRAM の RAM 容量欄を実際の RAM サイズに合わせるかどうかを指定します。
                   1117: <tt>0</tt> なら何もしません (実機と同じ)。
                   1118: <tt>1</tt> なら、アプリケーション起動時に
                   1119: SRAM の $ed0008.L (RAM 容量) を ram-size の設定値で更新します。
                   1120: この更新は、
                   1121: アプリケーション起動時に SRAM マジックが正しく書かれている場合のみ行われます。
                   1122: デフォルトは <tt>1</tt> です。
1.1.1.15  root     1123: <q>Specifies whether to synchronize a RAM size field in SRAM
1.1.1.14  root     1124: with real RAM size or not.
                   1125: If <tt>0</tt>, the application will do nothing (as same as the real).
                   1126: If <tt>1</tt>, the application updates(synchronizes)
                   1127: $ed0008.L (RAM size) in SRAM with configuration value of ram-size.
                   1128: This update is performed once only if
                   1129: the SRAM magic string is correct at the application startup.
1.1.1.15  root     1130: The default is <tt>1</tt>.</q></p></dd>
                   1131: <dt class=dt-indent><tt>xxx-news-sic-ignore = <i>integer</i></tt></dt>
                   1132: <dd>(NEWS Only)
                   1133: 未実装の SCSI コントローラおよび DMA
                   1134: コントローラ領域へのアクセスを無視するか指定します。
                   1135: 現状 (2022/08)、NetBSD/m68k はこの領域へのバスエラーを処理できず、
                   1136: uvm_fault のパニックを起こしてしまいます。
                   1137: <tt>1</tt> にするととりあえず si(4) へのアクセスが不調に終わって
                   1138: (他に問題がなければ) NetBSD/news68k が起動できます。
                   1139: デフォルトは <tt>0</tt> です。
                   1140: このオプションは暫定的なもので将来廃止される予定です。
                   1141: <q>
                   1142: Specifies whether to ignore accesses to unimplemented
                   1143: SCSI controller and DMA controller areas.
                   1144: As of Aug. 2022, NetBSD/m68k can not handle bus errors to this area,
                   1145: and it happens uvm_fault panic.
                   1146: Specifying <tt>1</tt> avoids it and NetBSD/news68k can boot.
                   1147: The default value is <tt>0</tt>.
                   1148: This option is temporary and will be discontinued in the future.</q></p></dd>
1.1       root     1149: </dl>
                   1150: </div>
1.1.1.15  root     1151: </details>
1.1       root     1152: 
                   1153: 
1.1.1.8   root     1154: <a name="aboutvm"></a>
1.1.1.15  root     1155: <details open style="padding-top: 1em">
                   1156: <summary><span class=h4>4. VM について <q>About VM</q></span></summary>
                   1157: <a name=""></a>
                   1158: <details open style="padding-top: 1em">
                   1159: <summary><span class=h5>4.1. 実装状況 <q>Implementation Status</q></span></summary><div class="main">
1.1.1.14  root     1160: <table cellpadding=0 cellspacing=0>
                   1161: <tr><td style="padding-right: 1em">◎ <td>: ほぼ実装済み <q>Mostly implemented</q>
                   1162: <tr><td>○    <td>: 困らない程度には実装済み <q>Works</q>
                   1163: <tr><td>△    <td>: とりあえず動いてる程度 <q>Works somehow</q>
                   1164: <tr><td>×     <td>: 未実装 <q>Not implemented</q>
                   1165: <tr><td>—    <td>: 実装予定なし <q>Not planned</q>
                   1166: </table>
                   1167: <style type="text/css">
                   1168: .pghd {
                   1169:        border: 0px none;
                   1170:        border-bottom: 1px solid black;
                   1171:        padding-top: 1em;
                   1172: }
                   1173: .pgth {
                   1174:        border-top: 0px none;
                   1175:        border-left: 1px solid black;
                   1176:        border-right: 1px solid black;
                   1177:        border-bottom: 1px solid black;
                   1178:        padding-right: 1ex;
                   1179: }
                   1180: .pgtd {
                   1181:        border-top: 0px none;
                   1182:        border-left: 0px none;
                   1183:        border-right: 1px solid black;
                   1184:        border-bottom: 1px solid black;
                   1185: }
                   1186: </style>
                   1187: <table cellspacing=0 cellpadding=0>
                   1188: <tr><td colspan=3 class=pghd>LUNA-I
                   1189: <tr><td class=pgth>MPU (68030)
                   1190:  <td class=pgtd style='padding: 0 1ex 0 1ex'>○
                   1191:  <td class=pgtd style='padding-left: 0.5ex'>キャッシュ未実装 <q>Cache not implemented</q>
                   1192: <tr><td class=pgth>FPU (68881)
                   1193:  <td class=pgtd style='padding: 0 1ex 0 1ex'>◎
                   1194:  <td class=pgtd style='padding-left: 0.5ex'>
                   1195: <tr><td class=pgth>BT454
                   1196:  <td class=pgtd style='padding: 0 1ex 0 1ex'>◎
                   1197:  <td class=pgtd style='padding-left: 0.5ex'>
                   1198: <tr><td class=pgth>CRTC2
                   1199:  <td class=pgtd style='padding: 0 1ex 0 1ex'>○
                   1200:  <td class=pgtd style='padding-left: 0.5ex'>標準で使用する値のみサポート
                   1201: <tr><td class=pgth>Frame buffer
                   1202:  <td class=pgtd style='padding: 0 1ex 0 1ex'>◎
                   1203:  <td class=pgtd style='padding-left: 0.5ex'>
                   1204: <tr><td class=pgth>Keyboard/Mouse
                   1205:  <td class=pgtd style='padding: 0 1ex 0 1ex'>◎
                   1206:  <td class=pgtd style='padding-left: 0.5ex'>
1.1.1.15  root     1207: <tr><td class=pgth>SIO (uPD7201)
1.1.1.14  root     1208:  <td class=pgtd style='padding: 0 1ex 0 1ex'>◎
                   1209:  <td class=pgtd style='padding-left: 0.5ex'>
1.1.1.15  root     1210: <tr><td class=pgth>PIO (8255)
1.1.1.14  root     1211:  <td class=pgtd style='padding: 0 1ex 0 1ex'>○
                   1212:  <td class=pgtd style='padding-left: 0.5ex'>
                   1213: <tr><td class=pgth>Ethernet (AM7990)
                   1214:  <td class=pgtd style='padding: 0 1ex 0 1ex'>◎
1.1.1.16! root     1215:  <td class=pgtd style='padding-left: 0.5ex'>マルチキャストフィルタを除く <q>Except multicast filter</q>
1.1.1.14  root     1216: <tr><td class=pgth>NVRAM&amp;RTC (MK48T02)
                   1217:  <td class=pgtd style='padding: 0 1ex 0 1ex'>◎
                   1218:  <td class=pgtd style='padding-left: 0.5ex'>
                   1219: <tr><td class=pgth>Front LCD
                   1220:  <td class=pgtd style='padding: 0 1ex 0 1ex'>◎
                   1221:  <td class=pgtd style='padding-left: 0.5ex'>
1.1.1.15  root     1222: <tr><td class=pgth>SPC (MB89352)
1.1.1.14  root     1223:  <td class=pgtd style='padding: 0 1ex 0 1ex'>◎
                   1224:  <td class=pgtd style='padding-left: 0.5ex'>
                   1225: <tr><td class=pgth>SCSI HD/CD/MO Devices
                   1226:  <td class=pgtd style='padding: 0 1ex 0 1ex'>○
                   1227:  <td class=pgtd style='padding-left: 0.5ex'>
1.1.1.16! root     1228: <tr><td class=pgth>XP(HD647180) CPU
        !          1229:  <td class=pgtd style='padding: 0 1ex 0 1ex'>△
1.1.1.15  root     1230:  <td class=pgtd style='padding-left: 0.5ex'>
1.1.1.16! root     1231: <tr><td class=pgth>XP(HD647180) Timer0/1
        !          1232:  <td class=pgtd style='padding: 0 1ex 0 1ex'>○
1.1.1.15  root     1233:  <td class=pgtd style='padding-left: 0.5ex'>
1.1.1.16! root     1234: <tr><td class=pgth>XP(HD647180) その他の内蔵デバイス<br><q>Other internal devices</q>
        !          1235:  <td class=pgtd style='padding: 0 1ex 0 1ex'>×
1.1.1.15  root     1236:  <td class=pgtd style='padding-left: 0.5ex'>
1.1.1.16! root     1237: <tr><td class=pgth>XP 周辺デバイス <q>Peripheral devices</q>
        !          1238:  <td class=pgtd style='padding: 0 1ex 0 1ex'>×
1.1.1.14  root     1239:  <td class=pgtd style='padding-left: 0.5ex'>
                   1240: <tr><td class=pgth>電源 <q>Power Circuit</q>
                   1241:  <td class=pgtd style='padding: 0 1ex 0 1ex'>○
                   1242:  <td class=pgtd style='padding-left: 0.5ex'>
                   1243: <tr><td colspan=3 class=pghd>LUNA-88K specific
                   1244: <tr><td class=pgth>MPU (88100 part)
                   1245:  <td class=pgtd style='padding: 0 1ex 0 1ex'>○ 
                   1246:  <td class=pgtd style='padding-left: 0.5ex'>マルチプロセッサ未実装、バグも未実装? <wbr><q>MP (and bugs?) not implemented</q>
                   1247: <tr><td class=pgth>MPU (88200 part)
                   1248:  <td class=pgtd style='padding: 0 1ex 0 1ex'>◎
                   1249:  <td class=pgtd style='padding-left: 0.5ex'>
                   1250: <tr><td class=pgth>MPU (88110)
                   1251:  <td class=pgtd style='padding: 0 1ex 0 1ex'>—
                   1252:  <td class=pgtd style='padding-left: 0.5ex'>実装予定なし <q>Not planned</q>
                   1253: <tr><td class=pgth>FUSEROM
                   1254:  <td class=pgtd style='padding: 0 1ex 0 1ex'>○
                   1255:  <td class=pgtd style='padding-left: 0.5ex'>
                   1256: <tr><td colspan=3 class=pghd>X68030
                   1257: <tr><td class=pgth>MPU (68030)
                   1258:  <td class=pgtd style='padding: 0 1ex 0 1ex'>○
                   1259:  <td class=pgtd style='padding-left: 0.5ex'>キャッシュ未実装、ファンクションコード未実装 <wbr><q>Cache and FC not implemented</q>
                   1260: <tr><td class=pgth>MPU (68EC030)
                   1261:  <td class=pgtd style='padding: 0 1ex 0 1ex'>—
                   1262:  <td class=pgtd style='padding-left: 0.5ex'>実装予定なし <q>Not planned</q>
                   1263: <tr><td class=pgth>FPU (68881)
                   1264:  <td class=pgtd style='padding: 0 1ex 0 1ex'>◎
                   1265:  <td class=pgtd style='padding-left: 0.5ex'>68882 は未実装 <q>68882 not implemented</q>
                   1266: <tr><td class=pgth>DMAC
                   1267:  <td class=pgtd style='padding: 0 1ex 0 1ex'>○
                   1268:  <td class=pgtd style='padding-left: 0.5ex'>
                   1269: <tr><td class=pgth>CRTC/VC
                   1270:  <td class=pgtd style='padding: 0 1ex 0 1ex'>△
                   1271:  <td class=pgtd style='padding-left: 0.5ex'>768x512 のテキスト画面のみサポート <wbr><q>Only 768x512 text screen supported</q>
                   1272: <tr><td class=pgth>FDC/FDD
                   1273:  <td class=pgtd style='padding: 0 1ex 0 1ex'>○
                   1274:  <td class=pgtd style='padding-left: 0.5ex'>
                   1275: <tr><td class=pgth>標準・拡張エリアセット <q>Areaset</q>
                   1276:  <td class=pgtd style='padding: 0 1ex 0 1ex'>×
                   1277:  <td class=pgtd style='padding-left: 0.5ex'>
                   1278: <tr><td class=pgth>ADPCM/OPM
                   1279:  <td class=pgtd style='padding: 0 1ex 0 1ex'>×
                   1280:  <td class=pgtd style='padding-left: 0.5ex'>
                   1281: <tr><td class=pgth>グラフィック機能全般 <wbr><q>All other graphics</q>
                   1282:  <td class=pgtd style='padding: 0 1ex 0 1ex'>×
                   1283:  <td class=pgtd style='padding-left: 0.5ex'>当面予定なし <q>Not scheduled</q>
                   1284: <tr><td class=pgth>Keyboard
                   1285:  <td class=pgtd style='padding: 0 1ex 0 1ex'>◎
                   1286:  <td class=pgtd style='padding-left: 0.5ex'>TVコントロールを除く <q>Except TV Control</q>
                   1287: <tr><td class=pgth>Mouse
                   1288:  <td class=pgtd style='padding: 0 1ex 0 1ex'>◎
                   1289:  <td class=pgtd style='padding-left: 0.5ex'>本体接続のみ
                   1290: <tr><td class=pgth>MFP
                   1291:  <td class=pgtd style='padding: 0 1ex 0 1ex'>△
                   1292:  <td class=pgtd style='padding-left: 0.5ex'>
1.1.1.15  root     1293: <tr><td class=pgth>PPI (8255)
1.1.1.14  root     1294:  <td class=pgtd style='padding: 0 1ex 0 1ex'>△
                   1295:  <td class=pgtd style='padding-left: 0.5ex'>
                   1296: <tr><td class=pgth>Printer
                   1297:  <td class=pgtd style='padding: 0 1ex 0 1ex'>×
                   1298:  <td class=pgtd style='padding-left: 0.5ex'>
                   1299: <tr><td class=pgth>RTC
                   1300:  <td class=pgtd style='padding: 0 1ex 0 1ex'>◎
                   1301:  <td class=pgtd style='padding-left: 0.5ex'>アラームを除く <q>Except Alarm</q>
1.1.1.15  root     1302: <tr><td class=pgth>SPC (MB89352)
1.1.1.14  root     1303:  <td class=pgtd style='padding: 0 1ex 0 1ex'>◎
                   1304:  <td class=pgtd style='padding-left: 0.5ex'>
                   1305: <tr><td class=pgth>SCSI HD/CD/MO Devices
                   1306:  <td class=pgtd style='padding: 0 1ex 0 1ex'>○
                   1307:  <td class=pgtd style='padding-left: 0.5ex'>
1.1.1.15  root     1308: <tr><td class=pgth>SCC (Z8530)
1.1.1.14  root     1309:  <td class=pgtd style='padding: 0 1ex 0 1ex'>◎
                   1310:  <td class=pgtd style='padding-left: 0.5ex'>
                   1311: <tr><td class=pgth>SRAM
                   1312:  <td class=pgtd style='padding: 0 1ex 0 1ex'>◎
                   1313:  <td class=pgtd style='padding-left: 0.5ex'>
                   1314: <tr><td class=pgth>システムポート<q>System port</q>
                   1315:  <td class=pgtd style='padding: 0 1ex 0 1ex'>△
                   1316:  <td class=pgtd style='padding-left: 0.5ex'>
                   1317: <tr><td class=pgth>テキスト画面<q>Text screen</q>
                   1318:  <td class=pgtd style='padding: 0 1ex 0 1ex'>○
                   1319:  <td class=pgtd style='padding-left: 0.5ex'>
                   1320: <tr><td class=pgth>電源 <q>Power curcuit</q>
                   1321:  <td class=pgtd style='padding: 0 1ex 0 1ex'>○
                   1322:  <td class=pgtd style='padding-left: 0.5ex'>
1.1.1.16! root     1323: <tr><td class=pgth><span class="new">Nereid Ethernet</span>
        !          1324:  <td class=pgtd style='padding: 0 1ex 0 1ex'><span class="new">◎</span>
        !          1325:  <td class=pgtd style='padding-left: 0.5ex'><span class="new">マルチキャストフィルタを除く <q>Except multicast filter</q></span>
        !          1326: <tr><td class=pgth><span class="new">Nereid Bank memory</span>
        !          1327:  <td class=pgtd style='padding: 0 1ex 0 1ex'><span class="new">◎</span>
1.1.1.14  root     1328:  <td class=pgtd style='padding-left: 0.5ex'>
                   1329: <tr><td class=pgth>Nereid USB
                   1330:  <td class=pgtd style='padding: 0 1ex 0 1ex'>—
                   1331:  <td class=pgtd style='padding-left: 0.5ex'>実装予定なし <q>Not planned</q>
1.1.1.16! root     1332: <tr><td class=pgth>拡張メモリ <q>Extended memory</q>
        !          1333:  <td class=pgtd style='padding: 0 1ex 0 1ex'>○
1.1.1.15  root     1334:  <td class=pgtd style='padding-left: 0.5ex'>
                   1335: <tr><td colspan=3 class=pghd>NWS-1750
                   1336: <tr><td class=pgth>MPU (68030)
                   1337:  <td class=pgtd style='padding: 0 1ex 0 1ex'>○
                   1338:  <td class=pgtd style='padding-left: 0.5ex'>キャッシュ未実装 <q>Cache not implemented</q>
                   1339: <tr><td class=pgth>FPU (68881)
                   1340:  <td class=pgtd style='padding: 0 1ex 0 1ex'>◎
                   1341:  <td class=pgtd style='padding-left: 0.5ex'>68882 は未実装 <q>68882 not implemented</q>
                   1342: <tr><td class=pgth>PROM
                   1343:  <td class=pgtd style='padding: 0 1ex 0 1ex'>×
                   1344:  <td class=pgtd style='padding-left: 0.5ex'>
                   1345: <tr><td class=pgth>SCC (Z8530)
                   1346:  <td class=pgtd style='padding: 0 1ex 0 1ex'>◎
                   1347:  <td class=pgtd style='padding-left: 0.5ex'>チャンネル A のみホストに接続 <wbr><q>Only channel A is connected to the host</q>
                   1348: <tr><td class=pgth>Ethernet (AM7990)
                   1349:  <td class=pgtd style='padding: 0 1ex 0 1ex'>◎
1.1.1.16! root     1350:  <td class=pgtd style='padding-left: 0.5ex'>マルチキャストフィルタを除く <q>Except multicast filter</q>
1.1.1.15  root     1351: <tr><td class=pgth>NVRAM&amp;RTC (MK48T02)
                   1352:  <td class=pgtd style='padding: 0 1ex 0 1ex'>◎
                   1353:  <td class=pgtd style='padding-left: 0.5ex'>
                   1354: <tr><td class=pgth>Video Board
                   1355:  <td class=pgtd style='padding: 0 1ex 0 1ex'>×
                   1356:  <td class=pgtd style='padding-left: 0.5ex'>
                   1357: <tr><td class=pgth>Keyboard/Mouse
                   1358:  <td class=pgtd style='padding: 0 1ex 0 1ex'>×
                   1359:  <td class=pgtd style='padding-left: 0.5ex'>
                   1360: <tr><td class=pgth>SCSI Controller
                   1361:  <td class=pgtd style='padding: 0 1ex 0 1ex'>×
                   1362:  <td class=pgtd style='padding-left: 0.5ex'>
                   1363: <tr><td class=pgth>IDROM, DIP-SW, 100Hz Timer, 診断用LED
                   1364:  <td class=pgtd style='padding: 0 1ex 0 1ex'>○
                   1365:  <td class=pgtd style='padding-left: 0.5ex'>
                   1366: <tr><td class=pgth>AST, Lv2Intr
                   1367:  <td class=pgtd style='padding: 0 1ex 0 1ex'>×
                   1368:  <td class=pgtd style='padding-left: 0.5ex'>
                   1369: <tr><td class=pgth>電源 <q>Power Circuit</q>
1.1.1.14  root     1370:  <td class=pgtd style='padding: 0 1ex 0 1ex'>×
                   1371:  <td class=pgtd style='padding-left: 0.5ex'>
                   1372: </table>
                   1373: </div>
1.1.1.15  root     1374: </details>
1.1.1.14  root     1375: 
1.1.1.15  root     1376: <a name=""></a>
                   1377: <details open style="padding-top: 1em">
                   1378: <summary><span class=h5>4.2. MPU (68030)</span></summary><div class="main">
1.1.1.14  root     1379: 68030 はキャッシュが未実装です。
                   1380: これに伴い命令の所要クロック数もまだ正しくなく、
                   1381: そのためクロック測定などでは正確な値が出ません。
                   1382: また ATC (アドレス変換キャッシュ) は実際の仕様とは異なり高速化してあります。
                   1383: <q>68030 cache is not implemented.
                   1384: Therefore, number of clock cycle is not correct.
                   1385: ATC (Address Translation Cache) is differ from and faster than the real 68030.</q>
                   1386: </div>
1.1.1.15  root     1387: </details>
1.1.1.14  root     1388: 
1.1.1.15  root     1389: <a name=""></a>
                   1390: <details open style="padding-top: 1em">
                   1391: <summary><span class=h5>4.3. LUNA の ROM エミュレーション</span></summary><div class="main">
1.1.1.14  root     1392: LUNA-I、LUNA-88K で PROM の外部イメージを指定しない場合
                   1393: (<tt>prom-image</tt> が空の場合)、
                   1394: 内蔵の独自 ROM が動作し、コンソールモニタが起動します。
                   1395: このコンソールモニタの動作は実機のそれとよく似ていますが、
                   1396: これは実機確認の際に操作方法が違いすぎると(自分が)困るため仕方なく似せているもので、
                   1397: 忠実なコピーを作る目的ではありません。
                   1398: </div>
1.1.1.15  root     1399: </details>
1.1.1.14  root     1400: 
1.1.1.15  root     1401: <a name=""></a>
                   1402: <details open style="padding-top: 1em">
                   1403: <summary><span class=h5>4.4. X68030 の ROM (ROM30) エミュレーション</span></summary><div class="main">
1.1.1.14  root     1404: X68030 で ROM30 の外部イメージを指定しない場合
                   1405: (<tt>iplrom2-image</tt> が空の場合)、内蔵の独自 ROM が組み込まれます。
                   1406: 本来の ROM30 には SCSIIOCS の他に ROM デバッガなどが含まれていますが、
                   1407: 内蔵 ROM はこのうち SCSIIOCS を NetBSD/x68k が起動するのに十分なだけしか
                   1408: 実装していません。
                   1409: Human68k を起動する場合はお手元の実機から ROM イメージを作成してください。
                   1410: </div>
1.1.1.15  root     1411: </details>
1.1.1.14  root     1412: 
1.1.1.16! root     1413: <a name="nereid"></a>
        !          1414: <details open style="padding-top: 1em">
        !          1415: <summary><span class=h5>4.5. X68030 の Nereid エミュレーション</span></summary><div class="main"><span class="new">
        !          1416: 現実の Nereid はイーサネット/メモリ/USB の複合拡張ボードで、
        !          1417: このうちメモリは、メインメモリの増設に使える他、
        !          1418: メインメモリとして使わなかった領域をバンクメモリとして使うことも出来ます。
        !          1419: nono ではこの Nereid の機能のうちイーサネット (RTL8019AS)
        !          1420: とバンクメモリのみサポートします。
        !          1421: メインメモリの増設機能はエミュレータでは意味がないので実装しません。また
        !          1422: USB (SL811HS/T) の実装予定はありません。
        !          1423: <q>Nereid in the real world is a combined Ethernet/memory/USB expansion board.
        !          1424: Of these, the memory can be used to expand main memory,
        !          1425: and areas not used for the main memory can be used as bank memory.
        !          1426: nono supports only ethernet (RTL8019AS) and bank memory among
        !          1427: the functions of the Nereid expansion board.
        !          1428: Main memory expansion is not supported because it's meaningless on emulators.
        !          1429: Also, USB (SL811HS/T) is not planned for implementation.</q>
        !          1430: <br><br>
        !          1431: Nereid は DIPSW6,7 によりアドレス・割り込みベクタの組を2通り指定できるため、
        !          1432: 2枚まで同時に運用することが出来ます。
        !          1433: 本来 SW6 と SW7 は (衝突さえしなければ) 任意に組み合わせることが可能ですが、
        !          1434: nono では簡便のためボード #0 は SW6,7 が OFF、
        !          1435: ボード #1 は SW6,7 が ON と固定しています。
        !          1436: <q>Since Nereid can set to two different combinations of addresses and
        !          1437: interrupt vectors by DIPSW,
        !          1438: so up to two boards can be operated at the same time.
        !          1439: Originally, SW6 and SW7 can be arbitrarily combined
        !          1440: (as long as they don't collide), in nono however, for simpility,
        !          1441: SW6 and SW7 are fixed to be OFF on board #0, and
        !          1442: SW6 and SW7 are fixed to be ON on board #1.</q>
        !          1443: <blockquote>
        !          1444: <table border=1 rules=all class="new">
        !          1445: <tr><th><th>#0 (<tt>nereid0-*</tt>)<th>#1 (<tt>nereid1-*</tt>)
        !          1446: <tr><td align=center>ベースアドレス・割り込みベクタ<br><q>Base address and interrupt vectors</q>
        !          1447:  <td>$ece300,$f9,$fb<br>(SW7=OFF)
        !          1448:  <td>$eceb00,$f8,$fa<br>(SW7=ON)
        !          1449: <tr><td align=center>バンクメモリウィンドウ<br><q>Bank memory window</q>
        !          1450:  <td>$ee0000<br>(SW6=OFF)
        !          1451:  <td>$ef0000<br>(SW6=ON)
        !          1452: </table>
        !          1453: </blockquote>
        !          1454: バンクメモリは、メインメモリとして使わなかった領域を使用します。
        !          1455: そのため実機でもバンクメモリの容量は DIPSW のメインメモリ割り当て設定
        !          1456: (SW1-5) に依存します。
        !          1457: nono に関係する結論だけでいうと、
        !          1458: メインメモリへの割り当てを一切行わない場合はバンクメモリは 16MB 確保でき、
        !          1459: メインメモリへの割り当てをいくらかでも行うとバンクメモリは 4MB となります。
        !          1460: 設定の <tt>nereid<i>N</i>-ram-size</tt> はこの部分を指定していることになります。
        !          1461: またこの容量とは独立に SW8 でバンクメモリの有効・無効を指定できますので、
        !          1462: <tt>nereid<i>N</i>-ram-size</tt> が 0 (以下) というのは SW8
        !          1463: でバンクメモリを無効にしたことに相当します。
        !          1464: <q>Bank memory uses memory areas not used as the main memory.
        !          1465: So the bank memory size depends on the main memory settings (SW1-5).
        !          1466: As a result,
        !          1467: only if you don't allocate any memories to main memory,
        !          1468: the bank memory can be allocated 16MB.
        !          1469: Otherwise, the bank memory will be allocated 4MB.
        !          1470: Thus, <tt>nereid<i>N</i>-ram-size</tt> specifies this value.
        !          1471: Also, SW8 specifies enable/disable of the bank memory regardless of the size,
        !          1472: <tt>nereid<i>N</i>-ram-size = 0</tt> (or less) means disabling the bank memory.</q>
        !          1473: </span></div>
        !          1474: </details>
        !          1475: 
1.1.1.15  root     1476: <a name=""></a>
                   1477: <details open style="padding-top: 1em">
1.1.1.16! root     1478: <summary><span class=h5>4.6. NEWS エミュレーション</span></summary><div class="main">
1.1.1.15  root     1479: NEWS エミュレーションは未完成です。
                   1480: 今の所 -X でカーネルを直接起動することしか出来ません。
                   1481: </div>
                   1482: </details>
                   1483: 
                   1484: <a name=""></a>
                   1485: <details open style="padding-top: 1em">
1.1.1.16! root     1486: <summary><span class=h5>4.7. ステータスパネル <q>Status Panel</q></span></summary><div class="main">
1.1.1.8   root     1487: ステータスパネル中央にあるパフォーマンスメータのアイコンは
                   1488: 高速モードの状態を表示しています。
                   1489: ダブルクリックすると高速/等速モードの指定を切り替えることができます。
                   1490: <q>The performance meter's icon at the center of the status panel
                   1491: shows the VM speed status.
1.1.1.12  root     1492: You can switch full speed / syncronized mode by double-clicking
                   1493: on this icon.</q>
1.1.1.8   root     1494: <table>
                   1495: <tr><td valign=top>
                   1496: <image src="image/sp-ffmark0.png" style="padding:0.5ex; background-color:white">
                   1497: <td valign=top>…
                   1498: <td valign=top>
                   1499: マークなしの場合、ユーザが等速モードを指定していて、等速モードで実行中です。
                   1500: <q>When no icons are displayed,
                   1501: the user has specified syncronized mode and
                   1502: the VM is running in synchronized mode.</q>
                   1503: <tr><td valign=top>
1.1.1.12  root     1504: <image src="image/sp-ffmark2.png" style="padding:0.5ex; background-color:white">
1.1.1.8   root     1505: <td valign=top>…
                   1506: <td valign=top>
1.1.1.12  root     1507: 三角3つの場合、ユーザが高速モードを指定していて、高速モードで実行中です。
1.1.1.9   root     1508: 高速モード中はパーセントではなく何倍速で動作しているかを表します。
1.1.1.12  root     1509: <q>When an icon (three triangles) is displayed,
1.1.1.8   root     1510: the user has specified full speed mode and
1.1.1.12  root     1511: the VM is running in full speed mode.
1.1.1.8   root     1512: <tr><td valign=top>
1.1.1.12  root     1513: <image src="image/sp-ffmark1.png" style="padding:0.5ex; background-color:white">
1.1.1.8   root     1514: <td valign=top>…
                   1515: <td valign=top>
1.1.1.12  root     1516: 三角2つの場合、ユーザが高速モードを指定していて、等速モードで実行中です。
                   1517: 以下のいずれかの状態で起きます。
                   1518: <q>When an icon (two triangles) is displayed,
1.1.1.8   root     1519: the user has specified full speed mode and
1.1.1.12  root     1520: the VM is running in synchronized mode.
                   1521: This will happen when any of the following occurs:</q>
                   1522: <ul>
                   1523: <li>キー押下中(後述)あるいはキーボードブザー発声中
                   1524: <q>When any keys are pressed (see below),
                   1525: or the keyboard buzzer is sounding.
                   1526: <li>STOP instruction on m68k.
                   1527: <li>pseudo STOP state on m88k.
                   1528: </ul>
1.1.1.8   root     1529: </table>
                   1530: </div>
1.1.1.15  root     1531: </details>
1.1.1.8   root     1532: 
1.1.1.15  root     1533: <a name=""></a>
                   1534: <details open style="padding-top: 1em">
1.1.1.16! root     1535: <summary><span class=h5>4.8. DIPSW 設定ウィンドウ</span></summary><div class="main">
1.1.1.15  root     1536: DIPSW 設定ウィンドウでの変更はアプリケーション起動中のみ有効です。
                   1537: またここでの設定は即 VM に反映されますが、
                   1538: LUNA の場合 DIPSW の状態を
                   1539: PIO(8255) がラッチするのが概ね起動時および再起動時のみとなっています
                   1540: (厳密には PROM と XP が云々ですが)。
                   1541: </div>
                   1542: 
                   1543: <a name=""></a>
                   1544: <details open style="padding-top: 1em">
1.1.1.16! root     1545: <summary><span class=h5>4.9. メモリダンプモニタ <q>Memory Dump Monitor</q></span></summary><div class="main">
1.1.1.15  root     1546: メモリダンプモニタの出力形式を、バイト、ワード、ロングワード
                   1547: (m88k ではそれぞれバイト、ハーフワード、ワードと表現します)
                   1548: から選択できます。
                   1549: また 68030/88200 の MMU ディスクリプタとして表示させることもできます
                   1550: (この位置が正しいディスクリプタかどうかは関係なく表示します)。
1.1.1.16! root     1551: 逆アセンブルも、逆アセンブルウィンドウからこちらにマージしました。
1.1.1.15  root     1552: LUNA-I なら m68k、HD64180 の逆アセンブルが、
                   1553: LUNA-88K なら m88k、HD64180 の逆アセンブルが、
1.1.1.16! root     1554: X68030 と NEWS なら m68k の逆アセンブルが選択できます。
1.1.1.15  root     1555: <q>On memory dump monitor,
                   1556: you can choose the output format from byte, word and longword
                   1557: (In m88k, it is represented as byte, halfword and word respectively).
                   1558: Also you can choose 68030/88200 MMU descriptor format
                   1559: (It displays regardless of whether this address is used as descriptor or not).
1.1.1.16! root     1560: Disassemble is now merged from disassemble monitor.
1.1.1.15  root     1561: On LUNA-I, you can choose m68k and HD64180 disassemble.
                   1562: On LUNA-88K, you can choose m88k and HD64180 disassemble.
1.1.1.16! root     1563: On X68030 and NEWS, you can choose m68k disassemble.</q>
1.1.1.15  root     1564: <p>
                   1565: 表示されているダンプ値をダブルクリックすることでメモリの値を編集できます。
                   1566: 編集できるのはメモリと以下の部分のみです。
                   1567: <q>You can edit the memory value by double click.
1.1.1.16! root     1568: Only memory and the following areas are editable.</q>
1.1.1.15  root     1569: <ul>
                   1570: <li>NVRAM (LUNA and NEWS Only) …
                   1571: 編集するとただちにファイルも更新します。
                   1572: 後ろの8バイトは時計レジスタを兼ねているため編集不可です。
                   1573: <q>The backend file is also updated immediately when edited.
                   1574: The last 8 bytes are not editable since there are the clock register.</q>
                   1575: <li>Bitmap framebuffer (LUNA Only) … 共通プレーンは書き込み不可です。
                   1576: <q>The common plane is not editable.</q>
                   1577: <li>SRAM (X68030 Only) …
                   1578: 編集するとただちにファイルも更新します。
                   1579: <q>The backend file is also updated immediately when edited.</q>
                   1580: <li>TVRAM とテキストパレット (X68030 Only) <q>Text VRAM and text palette</q>
                   1581: </ul>
                   1582: </div>
                   1583: 
                   1584: <a name=""></a>
                   1585: <details open style="padding-top: 1em">
1.1.1.16! root     1586: <summary><span class=h5>4.10. デバイスマップモニタ <q>Device Map Monitor</q></span></summary><div class="main">
        !          1587: m68k/m88k バスに接続されているデバイスを表示します。
        !          1588: 32ビットアドレスのうち上位 8 ビット、256個分を表示しています。
        !          1589: 1枠が 16MB になります。
        !          1590: また、X68030 ではこのうち 24ビット空間を別モニタで表示します。
        !          1591: こちらは 1枠 8KB x 2048個です。
        !          1592: どちらも内部構造を表示しているだけなので名前に馴染みがない場合があるかもしれません。
        !          1593: </div>
        !          1594: 
        !          1595: <a name=""></a>
        !          1596: <details open style="padding-top: 1em">
        !          1597: <summary><span class=h5>4.11. キー入力モード <q>Key input mode</q></span></summary><div class="main">
1.1.1.14  root     1598: LUNA も X68030 もキーボードは通常日本語キーボードです
                   1599: (LUNA には英語キーボードも存在するようですが…)。
1.1.1.11  root     1600: そのため、ホストが日本語キーボードの場合とそうでない場合のために
                   1601: 2つの入力モードを用意しています。
                   1602: どちらも一長一短があります。
1.1.1.14  root     1603: <q>LUNA and X68030 has the Japanese keyboard
                   1604: (though I ever heard there are US keyboard for LUNA...).
1.1.1.11  root     1605: So nono provides two input modes
                   1606: for Japanese keyboard users and non Japanese keyboard users.
                   1607: Both have advantages and disadvantages.</q>
                   1608: <p>
                   1609: JP キーボードモードは、ホストが日本語キーボードであることを前提に
                   1610: 対応するキーの押下、開放をその都度 VM に入力します。
                   1611: メリットとしては動作が実機に近くなり、
                   1612: 特にキーリピート(をハードウェアが行わないこと)も忠実に再現可能です。
                   1613: デメリットは ALT + TAB やアクセラレータキーでメニューを開く場合などに
                   1614: キー入力が残ることがあることです
                   1615: (キーを押した後でフォーカスが外れるとキーを離したことが
                   1616: アプリケーションに通知されないため)。
                   1617: またホストが日本語キーボードでなければ使いづらいです。
                   1618: <q>JP keyboard mode assumes that the host uses the Japanese keyboard.
                   1619: Each time you presses and releases a key,
                   1620: nono sends the corresponding key-pressed or key-released to the VM.
                   1621: One advantage is that it's close to the real machine behavior,
                   1622: and another is that it can reproduce
                   1623: the LUNA keyboard itself does not perform a key repeat.
                   1624: On the other hand,
                   1625: one disadvantage is that key sometimes remains pressed,
                   1626: especially when you enter ALT + TAB to switch the application
                   1627: or enter accelerator key to open the menu
                   1628: (If the application loses the focus after the key is pressed,
                   1629: the application will not receive the subsequent key release).
                   1630: And another disadvantage is that
1.1.1.12  root     1631: it will be hard to use for non Japenese keyboard users.</q>
1.1.1.11  root     1632: <p>
                   1633: 一方、キャラクタ入力モードは、ホストから入力された「文字」を
1.1.1.14  root     1634: 再び LUNA/X68030 のキーコードに解釈し直して VM に入力するモードです。
1.1.1.11  root     1635: 例えばゲスト OS に "@" を入力したい場合、
                   1636: US キーボードなら [SHIFT] + [2] を、
                   1637: JP キーボードなら [@] キーを押しますが、
                   1638: どちらも VM には [@] キーの押下、[@] キーの開放が連続して送られます。
                   1639: US キーボードで [SHIFT] を押したことは通知されません。
                   1640: 逆に "=" を入力したい場合、
                   1641: US キーボードなら [=] キーを、
                   1642: JP キーボードなら [SHIFT] + [-] を押しますが、
                   1643: どちらも VM には
                   1644: [SHIFT]押下 → [-]押下 → [-]開放 → [SHIFT]開放のシーケンスが送られます。
                   1645: このようにホストキーボードのレイアウトによらず、
                   1646: 入力したい文字が入力できるようになり、
                   1647: 通常のタイピングで困ることはないと思います。
                   1648: デメリットは、通常の文字入力以外のタイピングはほぼ出来ないことです。
                   1649: [SHIFT] キーを押したままにすることや、
                   1650: 文字が入力できないキーの組み合わせは入力出来ません。
                   1651: もう一つのデメリットはキーリピート(をハードウェアが行わないこと)が再現できず、
                   1652: ホスト側のキーリピートが効いてしまうことです
                   1653: (本来キーリピートが動作しない ROM やブートローダでもキーリピートが効くことは
                   1654: 一般ユーザからはメリットに感じられるかも知れませんが)。
                   1655: <q>In contrast, in the character mode, when you type a character,
1.1.1.14  root     1656: nono re-converts it into the LUNA/X68030's key code and sends it to the VM.
1.1.1.11  root     1657: For example if you want to type "@" in the guest OS,
                   1658: you would press [SHIFT] + [2] on the US keyboard or [@] on the JP keyboard.
                   1659: In both cases, the sequence of
                   1660: [@]-pressed and [@]-released will be sent to the VM.
                   1661: Note that the fact that you pressed [SHIFT] key on the US keyboard
                   1662: will not be sent to the VM.
                   1663: Another example, if you want to type "=",
                   1664: you would press [=] on the US keyboard or [SHIFT] + [-] on the JP keyboard.
                   1665: In both cases, the sequence of
                   1666: [SHIFT]-pressed, [-]-pressed, [-]-released, and [SHIFT]-released
                   1667: will be sent to the VM.
                   1668: Thus, you can type what character you want to type,
                   1669: regardless of your keyboard layout.
                   1670: Of course there are some disadvantages.
                   1671: Firstly, it's hard to type any special characters,
                   1672: for example, you can not type any key conbinations
                   1673: that don't generate a character.
                   1674: Or you can not hold [SHIFT] key pressed.
                   1675: Secondly, the key repeat works (by the host),
                   1676: even though it should not work as a correct emulation
                   1677: (Although some of you may feel it an advantage).</q>
                   1678: </div>
1.1.1.15  root     1679: </details>
1.1.1.11  root     1680: 
1.1.1.15  root     1681: <a name=""></a>
                   1682: <details open style="padding-top: 1em">
1.1.1.16! root     1683: <summary><span class=h5>4.12. キャラクタ入力モードのキーコード対応表 <q>Keycode table in the character mode</q></span></summary><div class="main">
1.1.1.11  root     1684: キャラクタ入力モードでの、ホストから入力した文字と
                   1685: VM に送信されるキーの対応は次の通りです。
                   1686: ファンクションキーとカーソルキーは文字ではありませんが
                   1687: 特別に対応しています。
1.1.1.14  root     1688: ここに記載のないゲストキーはソフトウェアキーボードからのみ入力できます。
1.1.1.11  root     1689: <q>The following table shows the correspondence between
                   1690: the character that typed from the host
                   1691: and the key that will be sent to the VM.
                   1692: nono can recognize the function keys and arrow keys.
1.1.1.14  root     1693: The keys that not listed in this table can
1.1.1.11  root     1694: only be typed from the software keyboard window.</q>
                   1695: <p>
                   1696: <center>
                   1697: <style type="text/css">
                   1698: .keytable-whole {
                   1699:        display: inline-block;
                   1700:        vertical-align: top;
                   1701:        border: solid 1px;
                   1702: }
                   1703: .keytable-middle {
                   1704:        margin-left: 1em;
                   1705:        margin-right: 1em;
                   1706: }
                   1707: 
                   1708: .keytable-head {
                   1709:        text-align: left;
                   1710:        border-bottom: solid 1px;
                   1711: }
                   1712: .keytable-headl {
                   1713:        padding-right: 1em;
                   1714: }
                   1715: 
                   1716: .keytable-tdl {
                   1717:        padding-right: 1em;
                   1718: }
                   1719: .keytable-tdr {
                   1720: }
                   1721: </style>
                   1722: <table class='keytable-whole keytable-left' cellspacing=0 cellpadding=1>
                   1723: <tr><th class='keytable-head keytable-headl'>HostChar<th class='keytable-head keytable-headr'>GuestKey
                   1724: <tr><td class='keytable-tdl'><tt>a</tt> 〜 <tt>z</tt><td class='keytable-tdr'>[A] 〜 [Z]
                   1725: <tr><td class='keytable-tdl'><tt>0</tt> 〜 <tt>9</tt><td class='keytable-tdr'>[0] 〜 [9]
                   1726: <tr><td class='keytable-tdl'>SPACE<td class='keytable-tdr'>[SPACE]
                   1727: <tr><td class='keytable-tdl'><tt>-</tt><td class='keytable-tdr'>[-]
                   1728: <tr><td class='keytable-tdl'><tt>^</tt><td class='keytable-tdr'>[^]
                   1729: <tr><td class='keytable-tdl'><tt>&bsol;</tt><td class='keytable-tdr'>[&bsol;]
                   1730: <tr><td class='keytable-tdl'><tt>@</tt><td class='keytable-tdr'>[@]
                   1731: <tr><td class='keytable-tdl'><tt>[</tt><td class='keytable-tdr'>[[]
                   1732: <tr><td class='keytable-tdl'><tt>;</tt><td class='keytable-tdr'>[;]
                   1733: <tr><td class='keytable-tdl'><tt>:</tt><td class='keytable-tdr'>[:]
                   1734: <tr><td class='keytable-tdl'><tt>]</tt><td class='keytable-tdr'>[]]
                   1735: <tr><td class='keytable-tdl'><tt>,</tt><td class='keytable-tdr'>[,]
                   1736: <tr><td class='keytable-tdl'><tt>.</tt><td class='keytable-tdr'>[.]
                   1737: <tr><td class='keytable-tdl'><tt>/</tt><td class='keytable-tdr'>[/]
                   1738: </table>
                   1739: <table class='keytable-whole keytable-middle' cellspacing=0 cellpadding=1>
                   1740: <tr><th class='keytable-head keytable-headl'>HostChar<th class='keytable-head keytable-headr'>GuestKey
                   1741: <tr><td class='keytable-tdl'><tt>A</tt> 〜 <tt>Z</tt><td class='keytable-tdr'>[SHIFT]+[A] 〜 [SHIFT]+[Z]
                   1742: <tr><td class='keytable-tdl'><tt>!</tt><td class='keytable-tdr'>[SHIFT]+[1]
                   1743: <tr><td class='keytable-tdl'><tt>"</tt><td class='keytable-tdr'>[SHIFT]+[2]
                   1744: <tr><td class='keytable-tdl'><tt>#</tt><td class='keytable-tdr'>[SHIFT]+[3]
                   1745: <tr><td class='keytable-tdl'><tt>$</tt><td class='keytable-tdr'>[SHIFT]+[4]
                   1746: <tr><td class='keytable-tdl'><tt>%</tt><td class='keytable-tdr'>[SHIFT]+[5]
                   1747: <tr><td class='keytable-tdl'><tt>&amp;</tt><td class='keytable-tdr'>[SHIFT]+[6]
                   1748: <tr><td class='keytable-tdl'><tt>'</tt><td class='keytable-tdr'>[SHIFT]+[7]
                   1749: <tr><td class='keytable-tdl'><tt>(</tt><td class='keytable-tdr'>[SHIFT]+[8]
                   1750: <tr><td class='keytable-tdl'><tt>)</tt><td class='keytable-tdr'>[SHIFT]+[9]
                   1751: <tr><td class='keytable-tdl'><tt>=</tt><td class='keytable-tdr'>[SHIFT]+[-]
                   1752: <tr><td class='keytable-tdl'><tt>~</tt><td class='keytable-tdr'>[SHIFT]+[^]
                   1753: <tr><td class='keytable-tdl'><tt>|</tt><td class='keytable-tdr'>[SHIFT]+[&bsol;]
                   1754: <tr><td class='keytable-tdl'><tt>`</tt><td class='keytable-tdr'>[SHIFT]+[@]
                   1755: <tr><td class='keytable-tdl'><tt>{</tt><td class='keytable-tdr'>[SHIFT]+[[]
                   1756: <tr><td class='keytable-tdl'><tt>+</tt><td class='keytable-tdr'>[SHIFT]+[;]
                   1757: <tr><td class='keytable-tdl'><tt>*</tt><td class='keytable-tdr'>[SHIFT]+[:]
                   1758: <tr><td class='keytable-tdl'><tt>]</tt><td class='keytable-tdr'>[SHIFT]+[]]
                   1759: <tr><td class='keytable-tdl'><tt>&lt;</tt><td class='keytable-tdr'>[SHIFT]+[,]
                   1760: <tr><td class='keytable-tdl'><tt>&gt;</tt><td class='keytable-tdr'>[SHIFT]+[.]
                   1761: <tr><td class='keytable-tdl'><tt>?</tt><td class='keytable-tdr'>[SHIFT]+[/]
                   1762: <tr><td class='keytable-tdl'><tt>_</tt><td class='keytable-tdr'>[SHIFT]+[_]
                   1763: </table>
1.1.1.14  root     1764: <table class='keytable-whole keytable-middle' cellspacing=0 cellpadding=1>
1.1.1.11  root     1765: <tr><th class='keytable-head keytable-headl'>HostChar<th class='keytable-head keytable-headr'>GuestKey
                   1766: <tr><td class='keytable-tdl'>F1 〜 F10<td class='keytable-tdr'>[PF1] 〜 [PF10]
1.1.1.15  root     1767: <tr><td class='keytable-tdl'>F11<td class='keytable-tdr'>[PF10]
1.1.1.11  root     1768: <tr><td class='keytable-tdl'>↑<td class='keytable-tdr'>[↑]
                   1769: <tr><td class='keytable-tdl'>←<td class='keytable-tdr'>[←]
                   1770: <tr><td class='keytable-tdl'>→<td class='keytable-tdr'>[→]
                   1771: <tr><td class='keytable-tdl'>↓<td class='keytable-tdr'>[↓]
1.1.1.14  root     1772: <tr><td class='keytable-tdl'><tt>^@</tt><td class='keytable-tdr'>[CTRL]+[@]
                   1773: <tr><td class='keytable-tdl'><tt>^A</tt> 〜 <tt>^Z</tt><td class='keytable-tdr'>[CTRL]+[A] 〜 [CTRL]+[Z]
                   1774: <tr><td class='keytable-tdl'><tt>^[</tt><td class='keytable-tdr'>[ESC]
                   1775: <tr><td class='keytable-tdl'><tt>^\</tt><td class='keytable-tdr'>[CTRL]+[&bsol;]
                   1776: <tr><td class='keytable-tdl'><tt>^]</tt><td class='keytable-tdr'>[CTRL]+[]]
                   1777: <tr><td class='keytable-tdl'><tt>^^</tt><td class='keytable-tdr'>[CTRL]+[^]
                   1778: <tr><td class='keytable-tdl'><tt>^_</tt><td class='keytable-tdr'>[CTRL]+[_]
                   1779: <tr><td class='keytable-tdl'><tt>^H</tt><td class='keytable-tdr'>[BS]
                   1780: <tr><td class='keytable-tdl'><tt>^I</tt><td class='keytable-tdr'>[TAB]
                   1781: <tr><td class='keytable-tdl'><tt>^M</tt><td class='keytable-tdr'>[Enter]
1.1.1.11  root     1782: </table>
                   1783: </center>
                   1784: </div>
1.1.1.15  root     1785: </details>
1.1.1.11  root     1786: 
1.1.1.15  root     1787: <a name=""></a>
                   1788: <details open style="padding-top: 1em">
1.1.1.16! root     1789: <summary><span class=h5>4.13. JP キーボードモードのキーコード対応表 <q>Keycode table in the JP keyboard mode</q></span></summary><div class="main">
1.1.1.11  root     1790: JP キーボードモードでの、ホストキーと VM に送信されるキーの対応は次の通りです。
1.1.1.14  root     1791: ここに記載のないキーはソフトウェアキーボードからのみ入力出来ます。
1.1.1.11  root     1792: <q>The following table shows the correspondence between
                   1793: the host key and the guest key.
1.1.1.14  root     1794: The keys that not listed in this table can only be enter from
1.1.1.11  root     1795: the software keyboard window.</q>
                   1796: <p>
                   1797: <center>
                   1798: <table class='keytable-whole keytable-left' cellspacing=0 cellpadding=0>
                   1799: <tr><th class='keytable-head keytable-headl'>HostKey<th class='keytable-head keytable-headr'>GuestKey
                   1800: <tr><td class='keytable-tdl'>[0] 〜 [9]<td class='keytable-tdr'>[0] 〜 [9]
                   1801: <tr><td class='keytable-tdl'>[A] 〜 [Z]<td class='keytable-tdr'>[A] 〜 [Z]
                   1802: <tr><td class='keytable-tdl'>[-]<td class='keytable-tdr'>[-]
                   1803: <tr><td class='keytable-tdl'>[^]<td class='keytable-tdr'>[^]
                   1804: <tr><td class='keytable-tdl'>[&bsol;]<td class='keytable-tdr'>[&bsol;]
                   1805: <tr><td class='keytable-tdl'>[@]<td class='keytable-tdr'>[@]
                   1806: <tr><td class='keytable-tdl'>[[]<td class='keytable-tdr'>[[]
                   1807: <tr><td class='keytable-tdl'>[;]<td class='keytable-tdr'>[;]
                   1808: <tr><td class='keytable-tdl'>[:]<td class='keytable-tdr'>[:]
                   1809: <tr><td class='keytable-tdl'>[]]<td class='keytable-tdr'>[]]
                   1810: <tr><td class='keytable-tdl'>[,]<td class='keytable-tdr'>[,]
                   1811: <tr><td class='keytable-tdl'>[.]<td class='keytable-tdr'>[.]
                   1812: <tr><td class='keytable-tdl'>[/]<td class='keytable-tdr'>[/]
                   1813: <tr><td class='keytable-tdl'>[_]<td class='keytable-tdr'>[_]
                   1814: </table>
                   1815: <table class='keytable-whole keytable-middle' cellspacing=0 cellpadding=0>
                   1816: <tr><th class='keytable-head keytable-headl'>HostKey<th class='keytable-head keytable-headr'>GuestKey
                   1817: <tr><td class='keytable-tdl'>[ESC]<td class='keytable-tdr'>[ESC]
                   1818: <tr><td class='keytable-tdl'>[TAB]<td class='keytable-tdr'>[TAB]
                   1819: <tr><td class='keytable-tdl'>[CTRL]<td class='keytable-tdr'>[CTRL]
                   1820: <tr><td class='keytable-tdl'>[BS]<td class='keytable-tdr'>[BS]
                   1821: <tr><td class='keytable-tdl'>[Enter]<td class='keytable-tdr'>[Enter]
                   1822: <tr><td class='keytable-tdl'>[F1] 〜 [F10]<td class='keytable-tdr'>[PF1] 〜 [PF10]
1.1.1.15  root     1823: <tr><td class='keytable-tdl'>[F11]<td class='keytable-tdr'>[PF10]
1.1.1.14  root     1824: <tr><td class='keytable-tdl'>[SHIFT-L]<td class='keytable-tdr'>[SHIFT-L]
                   1825: <tr><td class='keytable-tdl'>[SHIFT-R]<td class='keytable-tdr'>[SHIFT-R]
                   1826: <tr><td class='keytable-tdl'>[↑]<td class='keytable-tdr'>[↑]
                   1827: <tr><td class='keytable-tdl'>[←]<td class='keytable-tdr'>[←]
                   1828: <tr><td class='keytable-tdl'>[→]<td class='keytable-tdr'>[→]
                   1829: <tr><td class='keytable-tdl'>[↓]<td class='keytable-tdr'>[↓]
                   1830: </table>
                   1831: <table class='keytable-whole keytable-right' cellspacing=0 cellpadding=0>
                   1832: <tr><th class='keytable-head keytable-headl'>HostKey<th class='keytable-head keytable-headr'>GuestKey
1.1.1.11  root     1833: <tr><td class='keytable-tdl'>[DEL]<td class='keytable-tdr'>Numpad[DEL]
                   1834: <tr><td class='keytable-tdl'>Numpad[0]〜[9]<td class='keytable-tdr'>Numpad[0]〜[9]
                   1835: <tr><td class='keytable-tdl'>Numpad[+]<td class='keytable-tdr'>Numpad[+]
                   1836: <tr><td class='keytable-tdl'>Numpad[-]<td class='keytable-tdr'>Numpad[-]
                   1837: <tr><td class='keytable-tdl'>Numpad[*]<td class='keytable-tdr'>Numpad[*]
                   1838: <tr><td class='keytable-tdl'>Numpad[/]<td class='keytable-tdr'>Numpad[/]
                   1839: <tr><td class='keytable-tdl'>Numpad[=]<td class='keytable-tdr'>Numpad[=]
                   1840: <tr><td class='keytable-tdl'>Numpad[.]<td class='keytable-tdr'>Numpad[.]
                   1841: <tr><td class='keytable-tdl'>Numpad[Enter]<td class='keytable-tdr'>Numpad[Enter]
                   1842: </table>
                   1843: </center>
                   1844: </div>
1.1.1.15  root     1845: </details>
1.1.1.11  root     1846: 
1.1.1.15  root     1847: <a name=""></a>
                   1848: <details open style="padding-top: 1em">
1.1.1.16! root     1849: <summary><span class=h5>4.14. キーリピート <q>Key Repeat</q></span></summary><div class="main">
1.1.1.8   root     1850: LUNA では、キーボードがハードウェア側でキーリピートを行わず、
                   1851: ソフトウェア(OS など)がキーリピートの処理を行います。
                   1852: そのため、キーリピートを実装していない LUNA の PROM や
                   1853: NetBSD/luna68k のブートローダではキーリピートは起きず、
                   1854: キーリピートを実装している NetBSD/luna68k カーネルではキーリピートが起こせます。
1.1.1.9   root     1855: キーリピートを起こす間隔をゲストのソフトウェアが測定しているということは、
1.1.1.8   root     1856: VM が高速動作するとキーリピートもそれに合わせて発生することになり、
                   1857: これをホスト側から防ぐ手段はありません。
                   1858: そこで nono ではキー入力が発生している間
                   1859: (キーが一つでも押されてからキーが全て離されるまでの間)、
                   1860: 高速モードが指示されていても VM を一時的に等速モードに落として実行します。
                   1861: 上記のアイコンがそれを区別しているのはこのためです。
                   1862: そのため、何らかの理由でキーが入りっぱなしになった場合
                   1863: (ALT + TAB やアクセラレータキーでメニューを開くと起きがちです)
                   1864: 高速モードが抑制されたままということが起きえます。
                   1865: その場合はソフトウェアキーボードからキー入力を解除するなどしてください。
1.1.1.11  root     1866: <q>On LUNA,
1.1.1.8   root     1867: key repeat is done by software(OS), not by the keyboard hardware.
                   1868: For this reason,
                   1869: key repeat doesn't occur on LUNA's PROM or NetBSD/luna68k's bootloader
                   1870: that don't implement it, and
                   1871: key repeat occurs on NetBSD/luna68k kernel that implements it.
1.1.1.9   root     1872: Since the timing of key repeat is measured by the guest software,
1.1.1.8   root     1873: if the VM is running faster than the real,
                   1874: the key repeat will occur faster, too.
                   1875: The host application doesn't have the way to avoid it.
                   1876: Therefore, nono will temporarily suppress the full speed mode
                   1877: while any keys are pressed.
                   1878: That is why the above-mentioned icon distinguishes them.
1.1.1.9   root     1879: If keys continue to be pressed for some reasons,
1.1.1.8   root     1880: the VM also continues to run syncronized mode.
1.1.1.12  root     1881: In this case, you can resolve it by using the software keyboard window.</q>
1.1.1.8   root     1882: </div>
1.1.1.15  root     1883: </details>
                   1884: </details>
1.1.1.8   root     1885: 
1.1.1.14  root     1886: 
1.1.1.8   root     1887: <a name="tryit"></a>
1.1.1.15  root     1888: <details open style="padding-top: 1em">
                   1889: <summary><span class=h4>5. 実行してみる <q>Try it</q></span></summary><a name=""></a>
                   1890: <details open style="padding-top: 1em">
                   1891: <summary><span class=h5>5.1. NetBSD/luna68k を実行してみる <q>Try NetBSD/luna68k</q></span></summary><div class="main">
1.1.1.9   root     1892: つついさんが NetBSD/luna68k 9.2 の liveimage を用意されています。
                   1893: <q>Tsutsui-san has provided a liveimage of NetBSD/luna68k 9.2.</q>
                   1894: <dl>
1.1.1.12  root     1895: <dd><a href="https://twitter.com/tsutsuii/status/1436381589211017217"
                   1896: >https://twitter.com/tsutsuii/status/1436381589211017217</a><br>
1.1.1.9   root     1897: </dl>
                   1898: ここではこれを起動してみます。<q>Let's try it.</q>
1.1.1.2   root     1899: <br>
                   1900: <ol>
                   1901: <li>どこかに nono 用のディレクトリを用意し(例えば ~/nono/)、
1.1       root     1902: その中に VM ディレクトリを用意します (例えば ~/nono/luna/)。
1.1.1.3   root     1903: <q>Create a directory somewhere for nono (for example ~/nono/),
1.1.1.9   root     1904: and create subdirectories for individual VMs in it
                   1905: (for example ~/nono/luna/).</q>
1.1       root     1906: 
1.1.1.3   root     1907: <li>以下のリンクからイメージファイルをダウンロードして展開し、
1.1.1.2   root     1908: VM ディレクトリ ~/nono/luna/ に置きます。
1.1.1.3   root     1909: <q>Download imagefile from the following link,
1.1.1.8   root     1910: extract it and place it in the VM directory, ~/nono/luna/.</q>
1.1.1.3   root     1911: <blockquote>
1.1.1.12  root     1912: <a href="http://teokurebsd.org/netbsd/liveimage/20210910-luna68k/"
                   1913: >http://teokurebsd.org/netbsd/liveimage/20210910-luna68k/</a>
1.1.1.3   root     1914: </blockquote>
1.1.1.2   root     1915: 
1.1.1.9   root     1916: <li>以下の内容の設定ファイル nono.cfg を VM ディレクトリ ~/nono/luna/
                   1917: に作成します。
                   1918: ここでは説明を簡単にするためネットワークなしにしていますが、
                   1919: ネットワーク設定は必要に応じて行ってください。
1.1.1.8   root     1920: <q>Create a configuration file nono.cfg in the VM directory, ~/nono/luna/,
1.1.1.9   root     1921: with following contents.
                   1922: By the way, to simplify the explanation, we assume there is no network here.
                   1923: However, please configure the network if necessary.</q>
1.1.1.2   root     1924: <blockquote class="file"><pre>
                   1925: vmtype = luna
1.1.1.12  root     1926: spc0-id6-image = hd,liveimage-luna68k-with-packages-20210910.img
1.1.1.9   root     1927: hostnet-driver = none
1.1.1.2   root     1928: </pre></blockquote>
1.1.1.9   root     1929: 
1.1.1.2   root     1930: <li><tt>nono -c ~/nono/luna</tt> で起動します
                   1931: (VM ディレクトリに自動的に NVRAM.DAT が作られます)。
                   1932: <q>Run as <tt>nono -c ~/nono/luna</tt>.
1.1.1.4   root     1933: (NVRAM.DAT will be created automatically in the VM directory)</q>
1.1.1.14  root     1934: 
1.1.1.2   root     1935: <li>Emulated ROM Monitor が起動するので、
                   1936: 初回は以下のように入力すると NetBSD が起動します。
                   1937: <q>The emulated ROM Monitor will be executed.
                   1938: Then, only for the first time,
                   1939: entering the following can boot NetBSD.</q>
1.1.1.9   root     1940: <blockquote><pre>
                   1941: k&#x23ce;
                   1942: &#x23ce;
                   1943: &#x23ce;
                   1944: d&#x23ce;
                   1945: boot&#x23ce;
                   1946: g&#x23ce;
                   1947: x&#x23ce;
                   1948: </pre></blockquote>
                   1949: 画面はこんな感じのはずです (太字が入力部分)。
                   1950: <q>You will see a screen like this.  The bold text indicates
                   1951: the characters you need to enter.</q>
1.1.1.2   root     1952: <blockquote class="file"><pre>
1.1.1.16! root     1953: NONO 0.6.0 Emulated ROM Monitor for LUNA-I
1.1.1.9   root     1954: 
                   1955: ** NVRAM Initialized.
                   1956: 
                   1957: &gt;<b>k&#x23ce;</b>
                   1958: controller: dk  ?<b>&#x23ce;</b>
                   1959: drive unit: 0  ?<b>&#x23ce;</b>
                   1960: partition : c  ?<b>d&#x23ce;</b>
                   1961: filename  : vmunix  ?<b>boot&#x23ce;</b>
                   1962: &gt;<b>g&#x23ce;</b>
                   1963: Loaded.  Entry point = $00700000
                   1964: &gt;<b>x&#x23ce;</b>
1.1.1.2   root     1965: </pre></blockquote>
                   1966: この内容は NVRAM.DAT に記録されているので次回以降は直接 NetBSD が起動します。
1.1.1.8   root     1967: <q>The information you have just entered is recorded in the NVRAM,
1.1.1.14  root     1968: so next time it will boot NetBSD automatically.</q>
1.1.1.9   root     1969: <li>初回起動時、
                   1970: Updating fontconfig cache はあほみたいに時間がかかりますが、
                   1971: nono がハングアップしてるわけではありません(>_<)。
1.1.1.14  root     1972: また初回は起動後数時間めちゃくちゃ重たいですが、
1.1.1.9   root     1973: これはバックグラウンドで makemandb が動くためで
                   1974: nono のせいではありません(>_<)。
                   1975: <q>At the first boot, you will see the console stops after printing
                   1976: "Updating fontconfig cache".
                   1977: This is because the infamous fontconfig takes very looooong time.
                   1978: nono would not have hang-up.
1.1.1.14  root     1979: In addition, at the first boot, you will feel it's too heavy for several hours.
1.1.1.9   root     1980: This is because the infamous makemandb(8) runs heavily in the background
                   1981: for a looooong time.
                   1982: It's very sad to me that these two accidents which are far from the ideal
1.1.1.13  root     1983: are the first experiences of newcomers.</q>
1.1.1.9   root     1984: 
                   1985: <li>終了する時は root
                   1986: ユーザで &ldquo;<tt>shutdown -p now</tt>&rdquo; を実行してください。
                   1987: LUNA はソフトウェアから電源オフでき、
                   1988: VM の電源オフで nono も終了します。
                   1989: <q>To quit, type &ldquo;<tt>shutdown -p now</tt>&rdquo; as the root user.
                   1990: LUNA can be powered off by software,
                   1991: and nono will terminate when the VM is powered off.</q>
1.1.1.2   root     1992: </ol>
1.1       root     1993: </div>
1.1.1.15  root     1994: </details>
1.1       root     1995: 
1.1.1.15  root     1996: <a name=""></a>
                   1997: <details open style="padding-top: 1em">
                   1998: <summary><span class=h5>5.2. OpenBSD/luna88k を実行してみる <q>Try OpenBSD/luna88k</q></span></summary><div class="main">
1.1.1.13  root     1999: あおやまさんが OpenBSD/luna88k 7.0 の liveimage を用意されています。
                   2000: <q>Aoyama-san has provided a liveimage of OpenBSD/luna88k 7.0.</q>
1.1.1.9   root     2001: <dl>
1.1.1.13  root     2002: <dd><a href="https://twitter.com/ao_kenji/status/1473611893386661888"
                   2003: >https://twitter.com/ao_kenji/status/1473611893386661888</a>
1.1.1.9   root     2004: </dl>
                   2005: ここではこれを起動してみます。<q>Let's try it.</q>
                   2006: <br>
                   2007: <ol>
                   2008: <li>どこかに nono 用のディレクトリを用意し(例えば ~/nono/)、
                   2009: その中に VM ディレクトリを用意します (例えば ~/nono/luna88k/)。
                   2010: <q>Create a directory somewhere for nono (for example ~/nono/),
                   2011: and create subdirectories for individual VMs in it
                   2012: (for example ~/nono/luna88k/).</q>
                   2013: 
1.1.1.13  root     2014: <li>以下のリンクから liveimage-luna88k-raw-20211221.img.gz
1.1.1.9   root     2015: をダウンロードして展開し、
                   2016: VM ディレクトリ ~/nono/luna88k/ に置きます。
1.1.1.13  root     2017: <q>Download liveimage-luna88k-raw-20211221.img.gz from the following link,
1.1.1.9   root     2018: extract it and place it in the VM directory, ~/nono/luna88k/.</q>
                   2019: <blockquote>
                   2020: <a href="http://www.nk-home.net/~aoyama/liveimage/"
                   2021: >http://www.nk-home.net/~aoyama/liveimage/</a>
                   2022: </blockquote>
                   2023: 
                   2024: <li>以下の内容の設定ファイル nono.cfg を VM ディレクトリ ~/nono/luna88k/
                   2025: に作成します。
                   2026: ここでは説明を簡単にするためネットワークなしにしていますが、
                   2027: ネットワーク設定は必要に応じて行ってください。
                   2028: <q>Create a configuration file nono.cfg in the VM directory, ~/nono/luna88k/,
                   2029: with following contents.
                   2030: By the way, to simplify the explanation, we assume there is no network here.
                   2031: However, please configure the network if necessary.</q>
                   2032: <blockquote class="file"><pre>
                   2033: vmtype = luna88k
1.1.1.13  root     2034: spc0-id6-image = hd,liveimage-luna88k-raw-20211221.img
1.1.1.9   root     2035: hostnet-driver = none
                   2036: </pre></blockquote>
                   2037: 
                   2038: <li><tt>nono -c ~/nono/luna88k</tt> で起動します
                   2039: (VM ディレクトリに自動的に NVRAM.DAT が作られます)。
                   2040: <q>Run as <tt>nono -c ~/nono/luna88k</tt>.
                   2041: (NVRAM.DAT will be created automatically in the VM directory)</q>
                   2042: <li>Emulated ROM Monitor が起動するので、
                   2043: 初回は以下のように入力すると OpenBSD が起動します。
                   2044: <q>The emulated ROM Monitor will be executed.
                   2045: Then, only for the first time,
                   2046: entering the following can boot OpenBSD.</q>
                   2047: <blockquote><pre>
                   2048: nvram boot_filename boot&#x23ce;
                   2049: y
                   2050: b&#x23ce;
                   2051: </pre></blockquote>
                   2052: 画面はこんな感じのはずです (太字が入力部分)。
                   2053: <q>You will see a screen like this.  The bold text indicates
                   2054: the characters you need to enter.</q>
                   2055: <blockquote class="file"><pre>
1.1.1.16! root     2056: NONO 0.6.0 Emulated ROM Monitor for LUNA-88K
1.1.1.9   root     2057: 
                   2058: ** NVRAM Initialized.
                   2059: 
                   2060: N&gt;<b>nvram boot_filename boot&#x23ce;</b>
                   2061: Update boot_filename : "vmunix" -&gt; "boot" (Y/[N]):<b>y</b>
                   2062: Updated
                   2063: N&gt;<b>b&#x23ce;</b>
                   2064: </pre></blockquote>
                   2065: この内容は NVRAM.DAT に記録されているので次回以降は直接 OpenBSD が起動します。
                   2066: <q>The information you have just entered is recorded in the NVRAM,
1.1.1.14  root     2067: so next time it will boot OpenBSD automatically.</q>
1.1.1.9   root     2068: 
                   2069: <li>終了する時は root
                   2070: ユーザで &ldquo;<tt>shutdown -p now</tt>&rdquo; を実行してください。
1.1.1.13  root     2071: LUNA-88K はソフトウェアから電源オフでき、
1.1.1.9   root     2072: VM の電源オフで nono も終了します。
                   2073: <q>To quit, type &ldquo;<tt>shutdown -p now</tt>&rdquo; as the root user.
1.1.1.13  root     2074: LUNA-88K can be powered off by software,
1.1.1.9   root     2075: and nono will terminate when the VM is powered off.</q>
                   2076: </ol>
                   2077: </div>
1.1.1.15  root     2078: </details>
1.1.1.9   root     2079: 
1.1.1.15  root     2080: 
                   2081: <a name=""></a>
                   2082: <details open style="padding-top: 1em">
                   2083: <summary><span class=h5>5.3. NetBSD/x68k を実行してみる <q>Try NetBSD/x68k</q></span></summary><div class="main">
1.1.1.14  root     2084: つついさんが NetBSD/x68k 9.2 の liveimage を用意されています。
                   2085: ここではこれを起動してみます。
                   2086: <q>Tsutsui-san has provided a liveimage of NetBSD/x68k 9.2.  Let's try it.</q>
                   2087: <br>
                   2088: <ol>
                   2089: <li>どこかに nono 用のディレクトリを用意し(例えば ~/nono/)、
                   2090: その中に VM ディレクトリを用意します (例えば ~/nono/x68k/)。
                   2091: <q>Create a directory somewhere for nono (for example ~/nono/),
                   2092: and create subdirectories for individual VMs in it
                   2093: (for example ~/nono/x68k/).</q>
                   2094: 
                   2095: <li>以下のリンクから
                   2096: plain-install か with-packages のお好みのほうをダウンロードして展開し、
                   2097: VM ディレクトリ ~/nono/x68k/ に置きます。
                   2098: <q>Download your favorite one of plain-install or with-packages
                   2099: from the following link,
                   2100: extract it and place it in the VM directory, ~/nono/x68k/.</q>
1.1.1.15  root     2101: <blockquote>
1.1.1.14  root     2102: <a href="http://teokurebsd.org/netbsd/liveimage/20210613-x68k/"
                   2103: >http://teokurebsd.org/netbsd/liveimage/20210613-x68k/</a>
                   2104: </blockquote>
                   2105: 
                   2106: <li>以下の内容の設定ファイル nono.cfg を VM ディレクトリ ~/nono/x68k/
                   2107: に作成します。
1.1.1.16! root     2108: <span class="new">ここでは説明を簡単にするためネットワークなしにしていますが、
        !          2109: ネットワーク設定は必要に応じて行ってください。</span>
1.1.1.14  root     2110: <q>Create a configuration file nono.cfg in the VM directory, ~/nono/x68k/,
                   2111: with following contents.
1.1.1.16! root     2112: <span class="new">By the way, to simplify the explanation, we assume there is no network here.
        !          2113: However, please configure the network if necessary.</span></q>
1.1.1.14  root     2114: <blockquote class="file"><pre>
                   2115: vmtype = x68030
                   2116: spc0-id0-image = hd,liveimage-x68k-with-packages-20210613.hds
1.1.1.16! root     2117: hostnet0-driver = none
1.1.1.14  root     2118: </pre></blockquote>
                   2119: 
1.1.1.16! root     2120: <li>初回のみ <tt>nono -c ~/nono/x68k --create-sram</tt> を実行します。
1.1.1.15  root     2121: これで VM ディレクトリに初期状態の SRAM.DAT が作られます。
                   2122: <q>Only the first time, run as <tt>nono -c ~/nono/x68k --create-sram</tt>.
1.1.1.16! root     2123: This will create an initial SRAM.DAT in the VM directory.</q>
1.1.1.15  root     2124: 
                   2125: <li><tt>nono -c ~/nono/x68k</tt> で起動すると、
1.1.1.14  root     2126: HDD から NetBSD/x68k が起動します。
                   2127: 次回以降はこれだけで直接 NetBSD が起動します。
                   2128: <q>Again, run as <tt>nono -c ~/nono/x68k</tt>.
                   2129: NetBSD/x68k will be booted from HDD.
                   2130: Next time, it will boot NetBSD automatically.</q>
                   2131: 
                   2132: <li>初回起動後数時間はめちゃくちゃ重たいですが、
                   2133: これはバックグラウンドで makemandb が動くためで
                   2134: nono のせいではありません(>_<)。
                   2135: <q>At the first boot, you will feel it's too heavy for several hours.
                   2136: This is because the infamous makemandb(8) runs heavily in the background
                   2137: for a looooong time.
                   2138: It's very sad to me that an accident which is far from the ideal
                   2139: is the first experiences of newcomers.</q>
                   2140: 
                   2141: <li>NetBSD が起動した後なら (正確には powerd(8) が起動していれば)、
                   2142: 終了する時はメニューの「デバイス &gt; 操作 &gt; 電源ボタンを押す」
                   2143: でシャットダウンして電源オフになり、
                   2144: VM の電源オフで nono も終了します。
                   2145: <q>After NetBSD boots up (more precisely, if powerd(8) is running),
                   2146: you can shutdown and power off by
                   2147: "Device &gt; Operation &gt; Push Power button" on menu,
                   2148: and nono will terminate when the VM is powered off.</q>
                   2149: </ul>
                   2150: </div>
1.1.1.15  root     2151: </details>
                   2152: </details>
1.1.1.9   root     2153: 
1.1       root     2154: 
1.1.1.8   root     2155: <a name="network"></a>
1.1.1.15  root     2156: <details open style="padding-top: 1em">
                   2157: <summary><span class=h4>6. ホストネットワーク設定例 <q>Example of host network setup</q></span></summary><div class=main>
1.1.1.9   root     2158: wm0 を持つ NetBSD ホストに tap(4) デバイスを用いて
                   2159: nono のゲスト OS を接続する場合の設定例です。
                   2160: <ol>
                   2161: <li>
                   2162: 設定ファイル nono.cfg に以下の行を追加します
                   2163: (と言いつつ NetBSD では書かなくてもデフォルトでこの動作になりますが)
                   2164: <q>Add the following line to configuration file, nono.cfg.
                   2165: (Although you don't need to write it since these are default behavior
                   2166: on NetBSD)</q>
1.1       root     2167: <blockquote class="file"><pre>
1.1.1.9   root     2168: hostnet-driver = tap
                   2169: hostnet-tap-devpath = auto
1.1       root     2170: </pre></blockquote>
1.1.1.9   root     2171: 
1.1.1.5   root     2172: <li>デフォルトでは /dev/tap は一般ユーザからアクセスできないので、
                   2173: chmod で適当にパーミッションを与えます。
                   2174: 番号の付いていないほうの /dev/tap だけでいいです。
                   2175: sysinst 等で OS をアップグレードするとパーミッションが 600
                   2176: に戻るのがハマりポイントです。
1.1.1.9   root     2177: <q>By default, /dev/tap is only accessible to privileged user.
                   2178: You need to chmod /dev/tap (without unit number) appropriately.
1.1.1.12  root     2179: Note that upgrading using sysinst always reset the permission to 600.</q>
1.1.1.5   root     2180: 
                   2181: <li>bridge(4) インタフェースを作成し、
1.1.1.9   root     2182: ホストの外部(物理)インタフェースをブリッジに追加しておきます。
1.1.1.5   root     2183: <q>Create a bridge(4) interface, and
                   2184: add your physical interface to the bridge.</q>
1.1       root     2185: <blockquote class="cons"><pre>
1.1.1.5   root     2186: # ifconfig bridge0 create
1.1       root     2187: # brconfig bridge0 add wm0
                   2188: </pre></blockquote>
1.1.1.9   root     2189: 常用するなら /etc の設定ファイルに書いておきましょう。
                   2190: <q>If you use it regularly,
1.1.1.5   root     2191: you can put configuration file into /etc.</q>
                   2192: <blockquote>
                   2193: /etc/ifconfig.bridge0
                   2194: <pre class=file>
                   2195: create
                   2196: up
                   2197: !/sbin/brconfig $int add wm0
                   2198: </pre>
                   2199: <pre class=cons>
                   2200: # /etc/rc.d/network restart
                   2201: </pre>
                   2202: </blockquote>
                   2203: 
                   2204: <li>
                   2205: 一般ユーザに戻って、
                   2206: VM ディレクトリかその親ディレクトリに
                   2207: 次のような 2つのスクリプトを用意します。
1.1.1.9   root     2208: nono は tap(4) をオープンし、
                   2209: そのデバイス名を引数にこれらのスクリプトを呼びます。
1.1.1.5   root     2210: sudo の設定は別途行ってください。
                   2211: <q>Return to non-privileged user, and
                   2212: create following two scripts in the VM directory or its parent directory.
1.1.1.9   root     2213: nono will open tap(4) and
                   2214: invoke these scripts with the name of the device as an argument.
1.1.1.5   root     2215: In addition, you need to set up sudo separately.</q>
1.1       root     2216: <blockquote>
                   2217: nono-ifup
                   2218: <pre class=file>
                   2219: #!/bin/sh
1.1.1.5   root     2220: sudo /sbin/ifconfig $1 up
                   2221: sudo /sbin/brconfig bridge0 add $1
1.1       root     2222: </pre></blockquote>
                   2223: 
                   2224: <blockquote>
1.1.1.5   root     2225: nono-ifdown
1.1       root     2226: <pre class=file>
                   2227: #!/bin/sh
1.1.1.5   root     2228: sudo /sbin/brconfig bridge0 delete $1
                   2229: sudo /sbin/ifconfig $1 down
                   2230: </pre></blockquote>
                   2231: 
                   2232: <blockquote class="cons"><pre>
                   2233: % chmod +x nono-ifup nono-ifdown
1.1       root     2234: </pre></blockquote>
                   2235: 
1.1.1.5   root     2236: <li>nono を起動し、
                   2237: メニューの「モニタ &gt; ホスト &gt; ホストネットワーク」を開いて
1.1.1.9   root     2238: HostNet Driver: tap になっていれば動いてるはずです。
1.1.1.5   root     2239: <q>Run nono,
                   2240: and open "Monitor &gt; Host &gt; Host Network" window from menu.
1.1.1.9   root     2241: It's OK if you can see "HostNet Driver: tap".</q>
1.1.1.5   root     2242: 
                   2243: </ol>
1.1       root     2244: </div>
1.1.1.15  root     2245: </details>
                   2246: 
1.1       root     2247: 
1.1.1.13  root     2248: <a name="knownissues"></a>
1.1.1.15  root     2249: <details open style="padding-top: 1em">
                   2250: <summary><span class=h4>7. 既知の問題 <q>Known Issues</q></span></summary><div class="main">
1.1.1.13  root     2251: <ul>
1.1.1.14  root     2252: <li>デバッガのコンソール入力で、
1.1.1.15  root     2253: カーソルキーなどの特殊文字入力に対する表示が動作していません。
                   2254: <q>In debugger console, some special characters like cursor keys
1.1.1.13  root     2255: aren't printed correctly.</q>
1.1.1.14  root     2256: (since ver 0.3.0)
1.1.1.13  root     2257: <li>ホストが VirtualBox (on Windows?) で、
                   2258: VirtualBox の「マウス統合」が有効にしている場合、
                   2259: nono の「マウスモード」でマウスポインタが正しく移動しません。
                   2260: <q>If the host OS is running on VirtualBox (on Windows?) and
                   2261: "Mouse integration" on VirtualBox is enabled,
                   2262: the mouse pointer will not move as expected in nono's Mouse Mode.</q>
                   2263: (2021/12/30)
                   2264: 
                   2265: <li>Wayland の場合にウィンドウサイズが正しく設定されない場合があります。
                   2266: wxWidgets (3.0.5) のバグと思われます。
                   2267: <q>On Wayland, window size may be incorrect.
                   2268: This may be due to wxWidgets (3.0.5) bug.</q>
                   2269: (2021/12/30)
                   2270: 
                   2271: </ul>
                   2272: </div>
1.1.1.15  root     2273: </details>
                   2274: 
1.1       root     2275: 
1.1.1.10  root     2276: <a name="migrate"></a>
1.1.1.15  root     2277: <details open style="padding-top: 1em">
                   2278: <summary><span class=h4>8. 過去のバージョンからの移行方法 <q>How to migrate from old versions</q></span></summary><div class="main">
1.1.1.10  root     2279: バージョンアップに伴い設定ファイル等に非互換が発生する場合があります。
                   2280: その場合は以下の移行方法を参照して設定ファイル等を更新してください。
                   2281: <q>Some versions may have incompatibilities in the configuration files, etc.
                   2282: In such case, you may need to upgrade it by referring the following link.</q>
                   2283: <ul>
1.1.1.14  root     2284: <li><a href="upgrade-0.3.0.html">From ver 0.2.x to ver 0.3.0</a>
1.1.1.10  root     2285: <li><a href="upgrade-0.2.0.html">From ver 0.1.x to ver 0.2.0</a>
                   2286: </ul>
                   2287: </div>
1.1.1.15  root     2288: </details>
                   2289: 
1.1.1.2   root     2290: 
1.1.1.11  root     2291: <a name="changes"></a>
1.1.1.15  root     2292: <details open style="padding-top: 1em">
                   2293: <summary><span class=h4>9. 変更履歴 <q>Changes</q></span></summary><div class="main">
1.1.1.11  root     2294: See <a href="changes.html">changes.html</a>.
                   2295: </div>
1.1.1.15  root     2296: </details>
1.1.1.11  root     2297: 
                   2298: 
1.1.1.15  root     2299: <a name="license"></a>
                   2300: <details open style="padding-top: 1em">
                   2301: <summary><span class=h4>10. 連絡先、ライセンス等 <q>Contact, License, etc</q></span></summary>
                   2302: <a name=""></a>
                   2303: <details open style="padding-top: 1em">
                   2304: <summary><span class=h5>10.1. ライセンス <q>License</q></span></summary><div class="main">
                   2305: <ul>
                   2306: <li>
                   2307: nono 自身については
                   2308: <a href="nono-license.txt">nono-license.txt</a> を読んでください。
                   2309: <q>See nono-license.txt about nono itself.</q>
                   2310: <li>
                   2311: nono は無償公開されている X68030 の IPLROM を使用しています。
1.1.1.14  root     2312: <a href="fsharp-license.txt">許諾条件</a>を読んでください。
                   2313: <q>nono uses X68030 IPLROM image distributed without charge.
                   2314: You must read
                   2315: <a href="fsharp-license.txt">the license agreement</a>
                   2316: (even though it's Japanese original text only).</q>
1.1.1.15  root     2317: <li>
                   2318: nono は SIL Open Font License version 1.1 で配布されているフォントの
                   2319: 一部を改変して組み込んでいます。
                   2320: <q>nono modifies and embeds the font distributed as SIL Open Font License version 1.1.</q>
                   2321: </ul>
                   2322: </div>
1.1.1.2   root     2323: 
1.1.1.15  root     2324: </details>
                   2325: 
                   2326: <a name=""></a>
                   2327: <details open style="padding-top: 1em">
                   2328: <summary><span class=h5>10.2. 連絡先 <q>Contact us</q></span></summary><div class="main">
1.1.1.4   root     2329: バグ報告などは以下にお願いします。日本語でおk。
                   2330: <q>If you find any problems, please let me know.
                   2331: You may write in English.</q><br>
                   2332: <a href="https://github.com/isaki68k/nono-issue/issues"
                   2333: >https://github.com/isaki68k/nono-issue/issues</a>
                   2334: </div>
1.1.1.15  root     2335: </details>
1.1.1.4   root     2336: 
1.1.1.15  root     2337: <a name=""></a>
                   2338: <details open style="padding-top: 1em">
                   2339: <summary><span class=h5>10.3. パッチの提供について <q>About contributes</q></span></summary><div class="main">
1.1.1.2   root     2340: パッチを提供してくださる場合は以下に同意したものとします。
1.1.1.13  root     2341: <q>If you provide a patch to nono, we assume that you agree the following
1.1.1.12  root     2342: conditions:</q>
1.1.1.2   root     2343: <ul>
                   2344: <li>成果物が nono のライセンスに従って運用あるいは配布されること。
1.1.1.16! root     2345: <q>All your work will be operated or distributed under the nono license.</q>
1.1.1.2   root     2346: <li>ライセンスが将来変わる可能性があること。
                   2347: <q>The license may be changed in the future.</q>
                   2348: <li>著作部分に関して著作者人格権を行使しないこと。
                   2349: <q>Do not exercise your author's rights.</q>
                   2350: </ul>
                   2351: </div>
1.1.1.15  root     2352: </details>
1.1.1.2   root     2353: 
1.1.1.15  root     2354: <a name=""></a>
                   2355: <details open style="padding-top: 1em">
                   2356: <summary><span class=h5>10.4. Acknowledgements</span></summary><div class="main">
1.1.1.2   root     2357: nono は以下の広告条項を含むソースコードを利用しています。
                   2358: <q>nono uses source code with the following advertising clause.</q>
                   2359: <blockquote>
                   2360: This product includes software developed by Gordon Ross<br>
                   2361: This product includes software developed by the University of California, Lawrence Berkeley Laboratory.<br>
                   2362: </blockquote>
                   2363: </div>
1.1.1.15  root     2364: </details>
                   2365: </details>
1.1       root     2366: 
                   2367: <hr>
1.1.1.2   root     2368: nono project
1.1       root     2369: </body>
                   2370: </html>

unix.superglobalmegacorp.com

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