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

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

unix.superglobalmegacorp.com

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