![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to index.php CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [Isaki's NoNo m68k/m88k emulator] / nono / doc|
Return to index.php CVS log | Up to [Isaki's NoNo m68k/m88k emulator] / nono / doc |
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 root 32: <body>
1.1.1.11 root 33: <h3>nono <?=$nono_ver?> (<?=$nono_date?>)</h3>
1.1 root 34:
1.1.1.12! root 35: nono は NetBSD とかで動作する OMRON LUNA-I や LUNA-88K とかのエミュレータです。
! 36: <q>nono is OMRON LUNA-I and LUNA-88K emulator runs on NetBSD and etc.</q>
1.1.1.8 root 37:
38: <hr>
39:
40: <h4>Index of this page:</h4>
1.1.1.7 root 41: <div class="main">
1.1.1.12! root 42: <a href="#migrate">0. ver 0.2.x から ver 0.3.0 への移行方法 <q>How to migrate from ver 0.2.x to ver 0.2.0</q></a><br>
1.1.1.10 root 43: <a href="#build">1. ビルド方法 <q>How to build</q></a><br>
44: <a href="#commandline">2. コマンドラインオプション <q>Command Line Option</q></a><br>
45: <a href="#configuration">3. 設定 <q>Configuration</q></a><br>
46: <a href="#aboutvm">4. VM について <q>About VM</q></a><br>
47: <a href="#tryit">5. 実行してみる <q>Try it</q></a><br>
48: <a href="#network">6. ネットワーク設定例 <q>Example of network setup</q></a><br>
1.1.1.12! root 49: <a href="#knownissues">7. 既知の問題 <q>Known Issues</q></a><br>
! 50: <a href="#migrate">8. 過去のバージョンからの移行方法
1.1.1.9 root 51: <q>How to migrate from old versions</q></a><br>
1.1.1.12! root 52: <a href="#changes">9. 変更履歴 <q>Changes</q></a><br>
! 53: <a href="#license">10. 連絡先、ライセンス等 <q>Contact, License, etc</q></a><br>
! 54: </div>
! 55: <p>
! 56: <div class="main">
! 57: <span class="new">緑背景</span>は新規または目立った更新のあった箇所です。
! 58: <q><span class="new">Green Background</span> is new or updated paragraph.</q>
! 59: </div>
! 60:
! 61:
! 62: <a name="migrate"></a>
! 63: <h4>0. ver 0.2.x から ver 0.3.0 への移行方法 <q>How to migrate from ver 0.2.x to ver 0.3.0</q></h4>
! 64: <div class="main"><span class="new">
! 65: ver 0.3.0 ではデバッガに関する設定項目が ver 0.2.x までとは変更になっています。
! 66: これらを設定ファイルに記載している場合は
! 67: <a href="#configuration">このドキュメントの設定の章</a
! 68: >を参照して修正してください。
! 69: <q>Configuration about debugger has been changed from ver 0.2.x to ver 0.3.0.
! 70: If your configuration file has them, please update by yourself.
! 71: See <a href="#configuration">Configuration section in this document</a>.</q>
! 72: </span>
! 73: <p>
! 74: <span class="new">
! 75: 以下の設定項目は廃止になりました。
! 76: <q>The following item has been removed.</q></span>
! 77: <br>
! 78: <blockquote style="background-color: var(--light-pink);"><pre>
! 79: debugger-port = (default: 0)
! 80: </pre></blockquote>
! 81: <span class="new">
! 82: 代わりに以下の2つが追加されています。
! 83: <q>Instead, the following two items are added.</q></span>
! 84: <blockquote style="background-color: white;"><pre>
! 85: debugger-driver = (default: none)
! 86: debugger-tcp-port = (default: 0)
! 87: </pre></blockquote>
! 88: </span>
1.1.1.7 root 89: </div>
1.1.1.4 root 90:
1.1.1.12! root 91:
1.1.1.7 root 92: <a name="build"></a>
1.1.1.10 root 93: <h4>1. ビルド方法 <q>How to build</q></h4>
1.1 root 94: <div class="main">
1.1.1.5 root 95: ビルドには以下が必要です。
1.1.1.6 root 96: NetBSD(pkgsrc) なら wxWidgets は pkgsrc/x11/wxGTK30 です
1.1.1.7 root 97: (OPTIONS:gtk3 で動作確認しています)。
1.1.1.5 root 98: <q>The followings are required for build.
99: If you use NetBSD(pkgsrc),
1.1.1.7 root 100: wxWidgets is pkgsrc/x11/wxGTK30 (OPTIONS:gtk3 is tested).</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
! 109: (but 3.1.x "development" branch is not recommended)
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>
114: (NetBSD 以外でのビルドはサポートしていませんが)
1.1.1.9 root 115: Ubuntu 20.04 ではたぶん以下のパッケージが必要です。
1.1.1.10 root 116: <q>You may need the following packages on Ubuntu 20.04
1.1.1.5 root 117: (though we won't support non-NetBSD platform).</q>
118: </p>
1.1.1.7 root 119: <ul>
120: <li>
1.1.1.5 root 121: bmake
122: build-essential
123: gettext
124: libbsd-dev
125: libedit-dev
126: libkqueue-dev
1.1.1.9 root 127: libwxgtk3.0-gtk-dev
1.1.1.5 root 128: zlib1g-dev
1.1.1.7 root 129: </ul>
1.1.1.5 root 130:
1.1.1.2 root 131: <p>
1.1.1.8 root 132: nono のソースアーカイブを展開したら以下のようにビルドします。
1.1.1.2 root 133: configure には環境変数 CC、CXX でコンパイラを指定することが出来ます。
134: また wx-config が標準的な名前で提供されていないために見付けられない場合には
135: 環境変数 WX_CONFIG にパスを指定することが出来ます。
1.1.1.8 root 136: <q>Extract the nono's source archive and build as following.
1.1.1.2 root 137: You can specify C/C++ compiler using environment variable CC and CXX
138: if configure cannot find standard name suitable compiler.
139: Also, you can specify wx-config path using environment variable WX_CONFIG
140: if configure cannot find wx-config.</q>
1.1.1.12! root 141: </p><p>
! 142: <tt>-DNOTEST</tt> は開発者用のテストツールをビルドしないためのものです。
! 143: <q>With <tt>-DNOTEST</tt>, the build excludes test tools which is needed
! 144: for developers only.</q>
! 145:
1.1 root 146: <blockquote class="cons"><pre>
147: % ./configure
1.1.1.12! root 148: % make -DNOTEST depend
! 149: % make -DNOTEST
1.1.1.2 root 150: % su
151: # make install
1.1 root 152: </pre></blockquote>
1.1.1.2 root 153:
154: <p>
155: 2つの実行ファイルがインストールされます。
156: <tt>nono</tt> が GUI 版実行ファイル、
157: <tt>nono-cli</tt> がコマンドライン版です。
158: <q>Two executables will be installed.
1.1.1.7 root 159: <tt>nono</tt> is the GUI executable and <tt>nono-cli</tt> is
160: the command line executable.</q>
1.1 root 161:
162: </div>
163:
164:
1.1.1.7 root 165: <a name="commandline"></a>
1.1.1.10 root 166: <h4>2. コマンドラインオプション <q>Command Line Option</q></h4>
1.1 root 167: <div class="main">
168: <dl>
169: <?php
170: function item($name, $desc)
171: {
172: if (!is_array($name)) {
173: $name = array($name);
174: }
175: foreach ($name as $n) {
176: print "<dt class=dt-indent><tt>{$n}</tt></dt>\n";
177: }
178: print "<dd>{$desc}</p></dd>\n";
179: }
180: function option_item($name, $desc)
181: {
182: item($name, $desc);
183: }
184:
1.1.1.6 root 185: option_item("-c <i>vmpath</i>", <<<_EOM_
186: VM ディレクトリ/設定ファイルを指定します。
187: <i>vmpath</i> がディレクトリならそのディレクトリの中の nono.cfg
188: を設定ファイルとします。
189: <i>vmpath</i> がファイルならそれを設定ファイルとします。
190: そしていずれの場合も
191: 設定ファイルがあるディレクトリを VM ディレクトリとします。
192: -c オプションを省略すると <i>vmpath</i> をカレントディレクトリとします。
193: <q>Specifies the VM directory/configuration file.
194: If <i>vmpath</i> is a directory,
195: make nono.cfg in that directory a configuration file.
196: Or if <i>vmpath</i> is a file,
197: make the specified file a configuration file.
198: And in both cases,
199: make the directory where that file is located a VM directory.
200: If <tt>-c</tt> option is omitted,
1.1.1.11 root 201: <i>vmpath</i> is considered as the current directory.</q>
1.1 root 202: _EOM_
203: );
204:
205: option_item("-f", <<<_EOM_
206: 高速モードで起動します。
207: GUI なら起動後にもメニューから変更できますが、その初期値を変えるだけです。
1.1.1.2 root 208: <q>Boot as the fast mode.
209: You can change this mode on GUI menu after boot,
1.1.1.11 root 210: and the option only changes its initial state.</q>
1.1 root 211: _EOM_
212: );
213:
214: option_item("--fontsize <i>height</i>", <<<_EOM_
215: GUI 版のみ。
216: 全サブウインドウの起動時のフォントサイズを指定します。
1.1.1.2 root 217: <tt><i>height</i></tt> には 12, 16
1.1 root 218: のいずれかを指定します。デフォルトは <tt>12</tt> です。
1.1.1.3 root 219: 起動後にメニューから変更できます。
1.1.1.2 root 220: <q>
221: GUI Only.
222: Specifies the initial fontsize on all sub windows.
223: <tt><i>height</i></tt> is one of 12 or 16.
1.1.1.3 root 224: The default value is <tt>12</tt>.
1.1.1.11 root 225: You can change this value on GUI menu after boot.</q>
1.1 root 226: _EOM_
227: );
228:
229: option_item(array("-s <i>scale</i>",
230: "--scale <i>scale</i>"), <<<_EOM_
231: GUI 版のみ。
232: メインウィンドウの起動時のスケールを実数で指定します。
233: 起動後にもメニューからプリセットされた倍率には変更可能ですが、
234: 任意倍率は起動時のみ指定可能です
235: <span class=strike>(そのうちなんとかしたい)</span>。
236: デフォルトは 1.0 です。
1.1.1.2 root 237: <q>
238: GUI Only.
239: Specifies the initial main window scale in real number.
240: You can change this scale on GUI menu after boot,
241: but unlike this option, there are only a few preset choices
242: <span class=strike>(Should be improved in someday)</span>.
243: The default value is 1.0</q>
1.1 root 244: _EOM_
245: );
246:
247: option_item("--show-config", <<<_EOM_
248: 設定ファイルと <tt>-V</tt> オプションを読み込んだ結果を表示します。
1.1.1.2 root 249: <q>Shows the result of reading configuration file and
250: parsing <tt>-V</tt> options.</q>
1.1 root 251: _EOM_
252: );
253:
254: option_item("-v", <<<_EOM_
255: バージョンを表示します。
1.1.1.2 root 256: <q>Shows the version.</q>
1.1 root 257: _EOM_
258: );
259:
260: option_item("-V <i>name</i>=<i>value</i>", <<<_EOM_
1.1.1.3 root 261: 設定ファイルで指定した <tt><i>name</i>=<i>configvalue</i></tt> の代わりに
1.1.1.2 root 262: このオプションの <tt><i>name</i>=<i>value</i></tt> を適用します。
1.1.1.12! root 263: <tt><i>name</i></tt> が正しくない場合はエラー終了します。
1.1.1.3 root 264: <q>Use this <i>name</i>=<i>value</i>
1.1.1.12! root 265: instead of <i>name</i>=<i>configvalue</i> specified in configuration file.
! 266: If <tt><i>name</i></tt> is not correct, it will exit on error.</q>
1.1 root 267: _EOM_
268: );
1.1.1.9 root 269:
270: option_item("-X <i>file</i>", <<<_EOM_
271: ホストの <tt><i>file</i></tt> をロードして実行します。
272: <tt><i>file</i></tt> が相対パスの場合カレントディレクトリからのパスになります。
273: ファイルが gzip 圧縮されていれば自動的に展開します。
274: (展開後の) ファイル形式は a.out (OMAGIC) か ELF で、
275: 実際にはブートローダとカーネル程度しか想定していません。
1.1.1.11 root 276: 設定の <tt>prom-image</tt>、<tt>luna-dipsw1</tt> の内容(後述)によらず
277: 内蔵の互換 PROM で起動し、直ちにホストファイルを実行します。
1.1.1.9 root 278: <q>Loads and executes host's <tt><i>file</i></tt>.
279: If <tt><i>file</i></tt> is relative path,
280: it is path from the current directory.
281: If the file is gzip'd, it is automatically extracted.
282: The supported file format (after extracting) is a.out (OMAGIC) or ELF.
283: Actually, it only assumes bootloaders or kernels.
1.1.1.11 root 284: Regardless of <tt>prom-image</tt> and <tt>luna-dipsw1</tt> configuration
285: (see below),
286: the internal emulated PROM loads and executes the host file immediately.</q>
1.1.1.9 root 287: _EOM_
288: );
1.1 root 289: ?>
290: </dl>
291:
1.1.1.2 root 292: 以下開発用。<q>For developers:</q>
1.1 root 293: <dl>
294: <?php
295: // 項目間を空けない
296: function option_dev($name, $desc)
297: {
298: print "<dt class=dt-indent><tt>{$name}</tt></dt>\n";
299: print "<dd>{$desc}</dd>\n";
300: }
301:
1.1.1.3 root 302: option_dev("-b <i>hexaddr</i>[,<i>skipcount</i>]", <<<_EOM_
1.1 root 303: デバッガのブレークポイントを 16進数で指定します。
304: _EOM_
305: );
306:
307: option_dev("-C", <<<_EOM_
308: ログをコンソールにも出力します。
309: 通常はログウィンドウにだけ出力されます。
310: _EOM_
311: );
312:
313: option_dev("-d", <<<_EOM_
314: 起動時にデバッガプロンプトで停止します。
315: _EOM_
316: );
317:
318: option_dev("-D", <<<_EOM_
319: コンソールをデバッガとして使用します。
1.1.1.12! root 320: <span class="new">
! 321: 過去との互換性のために存在していますが、
! 322: <tt>-V debugger-driver=stdio</tt> と等価です。
! 323: </span>
1.1 root 324: _EOM_
325: );
326:
327: option_dev("-L <i>name1</i>=<i>level1</i>[,<i>name2</i>=<i>level2</i>,...]",
328: <<<_EOM_
329: ログレベルを指定します。
330: カンマで区切って複数指定することも出来ます。
331: <tt>-Lhelp</tt> で name の一覧を表示します。
332: _EOM_
333: );
334:
1.1.1.11 root 335: option_dev("--load-only <i>file</i>", <<<_EOM_
336: <tt>-X</tt> オプションと同様ですが、PROM のプロンプトで停止します。
337: _EOM_
338: );
339:
1.1 root 340: option_dev("-M <i>name</i>[,<i>name2</i>,...]", <<<_EOM_
341: 起動時に表示するモニタウィンドウを指定します。
342: カンマで区切って複数指定することも出来ます。
1.1.1.3 root 343: <tt>-Mhelp</tt> で name の一覧を表示します。
1.1 root 344: _EOM_
345: );
346:
347:
348: ?>
349: </dl>
350: </div>
351:
1.1.1.7 root 352:
353: <a name="configuration"></a>
1.1.1.10 root 354: <h4>3. 設定 <q>Configuration</q></h4>
1.1 root 355: <div class="main">
1.1.1.6 root 356: VM の設定ファイルはその VM ディレクトリ内の nono.cfg
357: (または -c で指定したファイル) です。
1.1 root 358: 書式は <tt>key = value</tt> 形式で1行1項目ずつです。
359: <tt>key</tt> と <tt>value</tt> の前後の空白は取り除かれます。
360: また空行と "<tt>#</tt>" で始まる行は無視します。
1.1.1.12! root 361: 知らないキーは警告を出した上で無視します。
1.1.1.6 root 362: <q>VM configuration file is nono.cfg
363: (or the file specified by -c option) in the VM directory.
1.1.1.2 root 364: Its syntax is <tt>key = value</tt> format, one per line.
365: White spaces before and after <tt>key</tt> and <tt>value</tt> are ignored.
1.1.1.12! root 366: Blank lines, lines beginning with "<tt>#</tt>" are also ignored.
! 367: The lines with unrecognized key are ignored with a warning.</q>
1.1 root 368: <p>
369: 設定項目は次の通りです。
1.1.1.2 root 370: <q>The configuration items are:</q>
1.1 root 371: <dl>
372: <?php
373: function config_item($name, $desc)
374: {
375: item($name, $desc);
376: }
377:
378: config_item("vmtype = <i>string</i>", <<<_EOM_
1.1.1.4 root 379: VM 種別を以下のいずれかから指定します。
380: 省略不可です。
381: <q>Specifies the VM type from the following.
1.1.1.11 root 382: This field is mandatory.</q>
1.1.1.4 root 383: <table cellspacing=0 cellpadding=0>
384: <tr><td> <td><tt>luna</tt> <td>… LUNA-I
1.1.1.12! root 385: <tr><td><td><tt>luna88k</tt> <td>… LUNA-88K
1.1.1.4 root 386: </table>
1.1 root 387: _EOM_
388: );
389:
1.1.1.8 root 390: config_item("clock-sync = <i>value</i>", <<<_EOM_
391: 仮想マシン内の時刻の同期方法を指定します。
392: <tt>real</tt> なら実時間に同期、<tt>virtual</tt> なら仮想時間に同期します。
393: デフォルトは <tt>real</tt> です。
394: この機能は実験中のため将来予告なく仕様が変更になる可能性があります。
395: <q>Specify how to synchronize the time in virtual machine.
396: If <tt>real</tt>, synchronize with the real time;
397: if <tt>virtual</tt>, synchronize with the virtual time.
398: The default is <tt>real</tt>.
399: This feature is under experimentation and may be changed in the future
1.1.1.11 root 400: without notice.</q>
1.1.1.8 root 401: _EOM_
402: );
403:
1.1.1.12! root 404: config_item("<span class='new'>debugger-driver = <i>string</i></span>", <<<_EOM_
! 405: <span class="new">
! 406: デバッガのコンソールドライバを指定します。
! 407: <tt>stdio</tt>、<tt>tcp</tt>、<tt>none</tt> が選択可能です。
! 408: <tt>stdio</tt> は標準入出力を使用します。
! 409: <tt>tcp</tt> は TCP ポートで TELNET プロトコルで待ち受けます。
! 410: <tt>none</tt> ならホスト側とは一切通信を行いません。
! 411: デフォルトは <tt>none</tt> です。
! 412: <q>Specifies console driver of the debugger.
! 413: <tt>stdio</tt>, <tt>tcp</tt>, and <tt>none</tt> can be specified.
! 414: <tt>stdio</tt> uses the standard input/output.
! 415: <tt>tcp</tt> listens on TCP port using TELNET protocol.
! 416: <tt>none</tt> doesn't make any communication with the host.
! 417: The default is <tt>none</tt>.</q>
! 418: </span>
! 419: _EOM_
! 420: );
! 421:
! 422: config_item("<span class='new'>debugger-tcp-port = <i>integer</i></span>",
! 423: <<<_EOM_
! 424: <span class="new">
! 425: デバッガのコンソールドライバが tcp の時の TCP 待ち受けポート番号を指定します。
! 426: <q>Specify the TCP port number that debugger console driver listens.</q>
! 427: </span>
1.1 root 428: _EOM_
429: );
430:
1.1.1.8 root 431: config_item("ethernet-macaddr = <i>string</i>", <<<_EOM_
432: イーサネットデバイスの仮想マシン側の MAC アドレスを指定します。
433: <tt><i>XX</i>:<i>XX</i>:<i>XX</i>:<i>XX</i>:<i>XX</i>:<i>XX</i></tt>
434: 形式で指定します。
435: <tt>auto</tt> なら自動的に決定します。
436: デフォルトは <tt>auto</tt> です。
437: _EOM_
438: );
439:
1.1.1.12! root 440: config_item("hostcom-driver = <i>string</i>", <<<_EOM_
! 441: シリアルポートのホスト側ドライバを指定します。
! 442: <tt>stdio</tt>、<tt>tcp</tt>、<tt>none</tt> が選択可能です。
! 443: <tt>stdio</tt> は標準入出力を使用します。
! 444: <tt>tcp</tt> は TCP ポートで TELNET プロトコルで待ち受けます。
! 445: <tt>none</tt> ならホスト側とは一切通信を行いません。
! 446: デフォルトは <tt>none</tt> です。
! 447: <q>Specifies the host driver of serial port.
! 448: <tt>stdio</tt>, <tt>tcp</tt>, and <tt>none</tt> can be specified.
! 449: <tt>stdio</tt> uses the standard input/output.
! 450: <tt>tcp</tt> listens on TCP port using TELNET protocol.
! 451: <tt>none</tt> doesn't make any communication with the host.
! 452: The default is <tt>none</tt>.</q>
! 453: _EOM_
! 454: );
! 455:
! 456: config_item("hostcom-tcp-port = <i>integer</i>", <<<_EOM_
! 457: ホストドライバが tcp の時の TCP 待ち受けポート番号を指定します。
! 458: <q>Specify the TCP port number that host driver listens.</q>
! 459: _EOM_
! 460: );
! 461:
! 462: config_item("hostcom-fallback = <i>integer</i>", <<<_EOM_
! 463: <tt>hostcom-driver</tt> で指定したドライバが使用可能でなかった時、
! 464: 0 ならプロセスを終了します。1 なら <tt>none</tt> を選択して実行を継続します。
! 465: デフォルトは 0 です。
! 466: <q>Specify the behavior when the driver which is selected by
! 467: <tt>hostcom-driver</tt> is unusable;
! 468: terminate the process if 0,
! 469: or continue to run using the <tt>none</tt> driver if 1.
! 470: The default is 0.</q>
! 471: _EOM_
! 472: );
! 473:
1.1.1.10 root 474: config_item("hostkbd-input = <i>string</i>", <<<_EOM_
475: ホストキーボードの入力モードを指定します。
476: <tt>char</tt> ならキャラクタ入力モード、
477: <tt>jp</tt> なら日本語キーボードモードです。
478: デフォルトは <tt>char</tt> です。
479: 詳細は <a href="#aboutvm">VM について</a> の章を参照してください。
480: <q>Specifies the input mode of the host keyboard.
481: <tt>char</tt> means the character mode,
482: <tt>jp</tt> means the Japanese keyboard mode.
483: The defualt is <tt>char</tt>.
484: See <a href="#aboutvm">About VM</a> for details.</q>
485: _EOM_
486: );
487:
1.1.1.8 root 488: config_item("hostnet-driver = <i>string</i>", <<<_EOM_
1.1 root 489: イーサネットデバイスのホスト側ドライバを指定します。
1.1.1.8 root 490: <tt>afpacket</tt>、<tt>bpf</tt>、<tt>tap</tt> のうち
491: ホスト OS がサポートしているものと <tt>auto</tt>、<tt>none</tt> が選択可能です。
492: <tt>afpacket</tt> は Linux の AF_PACKET ソケットを使用します。
493: <tt>bpf</tt> は bpf(4) デバイスを使用します。
494: <tt>tap</tt> は tap(4) インタフェースを使用します。
1.1 root 495: <tt>none</tt> ならホスト側とは一切通信を行いません。
1.1.1.8 root 496: <tt>auto</tt> ならホスト OS がサポートしているもののうち
497: <tt>tap</tt> → <tt>afpacket</tt> → <tt>bpf</tt> を順に試します。
498: デフォルトは <tt>auto</tt> です。
1.1.1.6 root 499: <q>Specifies the host driver of ethernet device.
1.1.1.8 root 500: <tt>afpacket</tt>, <tt>bpf</tt>, and <tt>tap</tt> can be specified
501: only if the host OS supports them.
502: <tt>auto</tt> and <tt>none</tt> can always be specified.
503: <tt>afpacket</tt> uses Linux's AF_PACKET socket,
504: <tt>bpf</tt> uses bpf(4) device,
505: and <tt>tap</tt> uses tap(4) interface.
506: <tt>none</tt> doesn't make any communication with the host.
507: If <tt>auto</tt> is specified,
508: it tries <tt>tap</tt>, <tt>afpacket</tt>, and <tt>bpf</tt> in that order
509: (if the host OS supports them).
510: The default is <tt>auto</tt>.</q>
1.1.1.6 root 511: _EOM_
512: );
513:
1.1.1.12! root 514: config_item("hostnet-afpacket-ifname = <i>ifname</i>", <<<_EOM_
1.1.1.8 root 515: ホストドライバが afpacket の時にバインドするインタフェースを1つ指定します。
516: <i>ifname</i> が <tt>auto</tt>
517: なら使用可能なインタフェースを1つ自動的に選択します。
518: デフォルトは <tt>auto</tt> です。
519: なお、このホストドライバではローカルホストとの通信は出来ません。
520: <q>Specify an interface name to bind to, when the host driver is afpacket.
521: If <tt>auto</tt> is specified as <i>ifname</i>,
522: it selects an usable interface automatically.
523: The default is <tt>auto</tt>.
524: Note that this host driver cannot communicate with the localhost.</q>
525: _EOM_
526: );
527:
1.1.1.12! root 528: config_item("hostnet-bpf-ifname = <i>ifname</i>", <<<_EOM_
1.1.1.8 root 529: ホストドライバが bpf の時にバインドするインタフェースを1つ指定します。
530: <i>ifname</i> が <tt>auto</tt>
531: なら使用可能なインタフェースを1つ自動的に選択します。
532: デフォルトは <tt>auto</tt> です。
533: なお、このホストドライバではローカルホストとの通信は出来ません。
534: <q>Specify an interface name to bind to, when the host driver is bpf.
535: If <tt>auto</tt> is specified as <i>ifname</i>,
536: it selects an usable interface automatically.
537: The default is <tt>auto</tt>.
538: Note that this host driver cannot communicate with the localhost.</q>
539: _EOM_
540: );
541:
1.1.1.12! root 542: config_item("hostnet-tap-devpath = <i>path</i>", <<<_EOM_
1.1.1.8 root 543: ホストドライバが tap の時に使用するデバイスを1つフルパスで指定します。
544: デフォルトは <tt>auto</tt> で、この場合は自動的にデバイスを選択します。
545: この時の探し方はホスト OS によって異なります。
546: Linux なら <tt>/dev/net/tun</tt> を指定したのと同じです。
1.1.1.6 root 547: OpenBSD なら <tt>/dev/tap0</tt> から <tt>/dev/tap9</tt> まで
548: 順番にオープンできるまで試します。
549: NetBSD (と FreeBSD) ならまず <tt>/dev/tap</tt> でクローニングを試み、
550: それが失敗すれば <tt>/dev/tap0</tt> から <tt>/dev/tap9</tt> までを
551: 順番にオープンできるまで試します。
1.1.1.8 root 552: いずれの場合も VM ディレクトリかその親ディレクトリに
553: <tt>nono-ifup</tt>, <tt>nono-ifdown</tt> という名前のシェルスクリプトが必要です。
554: 何もすることがない場合でも正常終了する空のシェルスクリプトを用意してください。
555: <q>
556: Specify a device pathname, when the host driver is tap.
557: The default is <tt>auto</tt>.
1.1.1.6 root 558: The behavior in this case depends on the host OS.
559: On Linux, it's the same as <tt>/dev/net/tun</tt>.
560: On OpenBSD, it will try from <tt>/dev/tap0</tt> to <tt>/dev/tap9</tt>
561: until successful.
562: On NetBSD (and FreeBSD), it will try cloning by <tt>/dev/tap</tt> first.
563: If that fails, then try from <tt>/dev/tap0</tt> to <tt>/dev/tap9</tt>
564: until successful.
1.1.1.8 root 565: In all cases, you need to prepare two shell script files which names are
566: <tt>nono-ifup</tt> and <tt>nono-ifdown</tt> in the VM directory or
567: its parent directory.
568: Even if you don't have anything to do in these scripts,
1.1.1.11 root 569: you need to prepare empty scripts that will terminate successfully.</q>
1.1 root 570: _EOM_
571: );
572:
1.1.1.8 root 573: config_item("hostnet-fallback = <i>integer</i>", <<<_EOM_
574: <tt>hostnet-driver</tt> で指定したドライバが使用可能でなかった時、
575: 0 ならプロセスを終了します。
576: 1 なら none を選択して実行を継続します。
577: デフォルトは 0 です。
578: <q>Specify the behavior when the driver which is selected by
579: <tt>hostnet-driver</tt> is unusable;
580: terminate the process if 0,
581: or continue to run using the <tt>none</tt> driver if 1.
582: The default is 0.</q>
1.1 root 583: _EOM_
584: );
585:
1.1.1.12! root 586: config_item("keyboard-connect = <i>integer</i>", <<<_EOM_
! 587: 起動時にキーボードを本体に接続するかどうかを指定します。
! 588: 1 なら接続し、0 なら接続しません。デフォルトは 1 です。
! 589: 起動後はメニューから変更可能です。
! 590: <q>Specify whether to connect keyboard on boot.
! 591: If 1, it is connected; if 0, it isn't connected. The default is 1.
! 592: You can change it on GUI menu after boot.</q>
! 593: _EOM_
! 594: );
! 595:
1.1.1.9 root 596: config_item("luna-adjust-misused-epoch = <i>integer</i>", <<<_EOM_
597: LUNA で誤った RTC epoch を採用している OS 向けに RTC
598: エミュレーションを補正するかどうかを
599: 指定します。0 なら補正をしません(実機と同じ動作)、
600: 1 なら補正します(現実世界と同じ動作)。
601: デフォルトは 1 で、通常 1 のままで使用して問題ありません。
602: <q>
603: Specifies whether nono corrects RTC emulation for OSes
604: that adopts wrong RTC epoch on LUNA.
605: 0 means making no correction
606: (this is the same behavior as the actual machine).
607: 1 means making correction
608: (this is the same behavior as the real world).
609: The default is 1. Normally, leave it 1.</q>
610: <p>
611: LUNA で採用している RTC (MK48T02) は2桁で保持している年の値が
612: 4 で割り切れる年をうるう年とする仕様です。
1.1.1.12! root 613: ところが NetBSD/luna68k、OpenBSD/luna88k などはこの
! 614: RTC の年の値を 1970年からの経過年として使用しています。
1.1.1.9 root 615: 例えば1970年はうるう年ではないため 2月28日の翌日は 3月1日ですが、
616: MK48T02 的には 00年であるためうるう年と認識し 2月28日の翌日が2月29日になります。
1.1.1.12! root 617: このように、これらの OS を使っている場合実機の
! 618: RTC は4年のうち約2年間、1日ずれた日付を指しているようです。
1.1.1.9 root 619: しかしながら、RTC の時刻は OS 起動時に一度読んだ後は基本的に参照しない上、
620: 今時必要なら NTP で時間を合わせるため、
621: 実機でも問題が顕在化することはまずないと思います。
622: nono の場合は実機と異なり、アプリケーション実行中しか RTC が進まないため、
623: 補正がない場合の動作が問題になるのは
624: nono を起動したまま偶数年の2月末日から日付をまたいで、
625: かつ nono を起動したまま OS を再起動して NTP などで時刻修正を行わなかった時
626: だけだと思います。
627: このオプションはほぼ開発者向けの動作確認用です。
628: _EOM_
629: );
630:
1.1 root 631: config_item("luna-dipsw1 = <i>string</i>", <<<_EOM_
632: 本体前面 DIPSW#1-1..#1-8 の内容を指定します。
633: "<tt>0</tt>" を DOWN、"<tt>1</tt>" を UP として、
634: これを8つ並べた形式で、前から順に #1..#8 に対応します。
1.1.1.4 root 635: <q>Specifies status of the front panel DIPSW#1-1..#1-8 using 8 digit.
1.1.1.2 root 636: "<tt>0</tt>" means DOWN and "<tt>1</tt>" means UP.
637: The first character corresponds to #1 and
1.1.1.3 root 638: the eighth character corresponds to #8.</q>
639: <p>
640: LUNA-I でのデフォルトは <tt>11110111</tt> です。
641: 各スイッチの内容は以下のリンクを参照してください。
642: <q>On LUNA-I, the default value is <tt>11110111</tt>.
1.1.1.4 root 643: See the following link about DIPSW.</q><br>
1.1.1.3 root 644: → <a href="https://wiki.netbsd.org/ports/luna68k/luna68k_info/"
645: >NetBSD/luna68k: Information</a>
1.1 root 646: <br>
1.1.1.12! root 647: LUNA-88K でのデフォルトは <tt>11111111</tt> です。
1.1.1.4 root 648: 各スイッチの内容は以下のリンクを参照してください。
1.1.1.12! root 649: <q>On LUNA-88K, the default value is <tt>11111111</tt>.
1.1.1.4 root 650: See the following link about DIPSW.</q><br>
651: → <a href="http://man.openbsd.org/boot_luna88k.8"
652: >OpenBSD manual pages: boot_luna88k(8)</a>
1.1 root 653: _EOM_
654: );
655:
656: config_item("luna-dipsw2 = <i>string</i>", <<<_EOM_
657: 本体前面 DIPSW#2-1..#2-8 の内容を指定します。
658: 書式は <tt>luna-dipsw1</tt> と同じです。
659: デフォルトは <tt>11111111</tt> です。
1.1.1.2 root 660: <q>Specifies status of the front panel DIPSW#2-1..#2-8.
661: The same syntax as <tt>luna-dipsw1</tt> is used.
662: The default value is <tt>11111111</tt>.</q>
1.1.1.3 root 663: <p>
1.1.1.4 root 664: NetBSD/luna68k のブートローダは、
665: DIPSW#2 が "<tt>11111111</tt>" なら自動的にカーネルをロードして実行し、
666: どれかでも "<tt>0</tt>" にするとプロンプトで停止するようです。
1.1 root 667: <span class=strike>(本当は #8 だけで制御するつもりだったんじゃないかという気がします)</span>
1.1.1.4 root 668: <q>NetBSD/luna68k bootloader will automatically load and execute the kernel,
669: if the DIPSW#2 is "<tt>11111111</tt>".
1.1.1.2 root 670: Otherwise, the bootloader will enter interactive mode.
671: <span class=strike>(I doubt that they actually wanted to switch with only #8)
1.1.1.11 root 672: </span></q>
1.1 root 673: _EOM_
674: );
675:
1.1.1.12! root 676: config_item("luna-video-plane = <i>integer</i>", <<<_EOM_
! 677: LUNA のビデオボードのプレーン数を 1 か 4 で指定します。
! 678: 1 ならモノクロビデオボード、
! 679: 4 なら16色 (4bpp) ビデオボードに相当します。
! 680: 8bpp ボードは(まだ?)サポートしていません。
! 681: デフォルトは今の所 1 です (将来変更するかもしれません)。
! 682: <q>Specify number of planes on LUNA video board.
! 683: The valid values are 1 or 4.
! 684: 1 means a monochrome video board,
! 685: 4 means 16-color (4bpp) video board.
! 686: Note that 8bpp video board is not (yet?) supported.
! 687: The default value is 1 for now (It may be changed in the future).</q>
! 688: _EOM_
! 689: );
! 690:
1.1.1.3 root 691: config_item("monitor-rate = <i>integer</i>", <<<_EOM_
692: テキスト系モニタウィンドウの更新頻度を Hz 単位で指定します。
693: 1 から 60 までの間で指定でき、デフォルトは 20Hz です。
694: 起動後にメニューからプリセットされた頻度には変更可能です。
695: <q>Specifies refresh rate of all text monitor windows in Hz.
696: It ranges from 1 to 60. The default is 20Hz.
697: You can change this value on GUI menu after boot,
1.1.1.11 root 698: but unlike this configuration value, there are only a few preset choices.</q>
1.1.1.3 root 699: _EOM_
700: );
701:
1.1 root 702: config_item("mpu-clock = <i>value</i>", <<<_EOM_
703: MPU のクロック数を MHz 単位で指定します。
1.1.1.12! root 704: デフォルトは LUNA-I なら 20MHz、LUNA-88K なら 25MHz です。
1.1.1.5 root 705: <q>Specifies the MPU clock in MHz.
1.1.1.12! root 706: The default value is 20MHz on LUNA-I, or 25MHz on LUNA-88K.</q>
1.1 root 707: _EOM_
708: );
709:
710: /* luna には不要
711: config_item("mpu-has-fpu", ""); */
712:
1.1.1.8 root 713: config_item("mpu-pseudo-stop = <i>integer</i>", <<<_EOM_
714: m88100 にて疑似 STOP 状態を有効にするかどうかを指定します。
715: 0 なら無効(実機と同じ動作)、1 なら有効で、デフォルトは 1 です。
716: m88100 には、m68k の STOP 命令 (割り込みが上がるまで何もせず待つ)
717: に相当する命令がなく、
718: 大抵ビジーウェイトループで割り込みが上がるのを待つことになります。
719: これは実機では (消費電力を減らす手段がないという些細な問題以外には)
720: 何のデメリットもないのですが、
721: エミュレータで特に高速動作させている時には割り込みが上がるまで
722: (例えば人間がキーを入力するまで) ホスト CPU パワーを使い潰してビジーウェイトループを実行し続けることになり、ホスト CPU があっつあつになります。
723: それを防ぐための機能です。
724: 特徴的な命令列を検出して実現しているので、すべての状況で動作するわけではありません。
725: _EOM_
726: );
727:
1.1.1.2 root 728: config_item("prom-image = <i>path</i>", <<<_EOM_
1.1.1.12! root 729: LUNA-I/LUNA-88K の外部 ROM イメージファイルのパスを指定します。
1.1.1.2 root 730: <i>path</i> がファイル名のみなら VM ディレクトリとその親ディレクトリからこのファイル名を検索します。
731: <i>path</i> が相対パスなら VM ディレクトリからの相対パスになります (現在のディレクトリからではありません)。
732: 空にすると内蔵 ROM を使用します。
733: デフォルトは空です。
1.1.1.12! root 734: <q>Specifies the LUNA-I/LUNA-88K's external ROM image file path.
1.1.1.2 root 735: If the <i>path</i> does not have any path delimiters,
736: the VM directory and then its parent directory will be searched.
737: If the <i>path</i> is a relative path,
738: it will be path from the VM directory, not from the current
739: directory.
740: If the <i>path</i> is empty, internal emulated ROM will be used.
741: The default value is empty.</q>
1.1 root 742: <p>
1.1.1.2 root 743: 実機を持っていない場合はこの値を空に (= デフォルトのままに) しておくと、
1.1.1.8 root 744: nono 内蔵のなんちゃって下位互換 ROM で起動します。
1.1.1.2 root 745: <q>If you does not have the real LUNA machines,
746: you can boot with nono's internal downward compatible emulated ROM
1.1.1.11 root 747: if you set this field empty (or leave it as the default).</q>
1.1 root 748: <p>
1.1.1.4 root 749: LUNA-I 実機を持っている場合は
750: ROM ファイルを指定することで実機 ROM で起動できます。
1.1.1.2 root 751: ROM ファイルは実機の 0x41000000-0x4101ffff (128KB) を保存したものです。
1.1.1.3 root 752: 今のところ ROM は V4.22 (Thu Jul 27 11:45:42 1989) のみサポートしています。
753: それ以外については何も分かりません。
1.1.1.4 root 754: <q>If you have the real LUNA-I machine,
1.1.1.2 root 755: you can boot with the real ROM spcifying the ROM file path.
1.1.1.4 root 756: The ROM file is extracted from 0x41000000-0x4101ffff (128KB) of
757: the real LUNA-I machine.
1.1.1.3 root 758: For now, only V4.22 (Thu Jul 27 11:45:42 1989) is supported.
1.1.1.11 root 759: I have no idea about other ROMs.</q>
1.1.1.4 root 760: <p>
1.1.1.12! root 761: LUNA-88K 実機の場合は 0x41000000-0x4103ffff (256KB) を保存したものです。
1.1.1.8 root 762: 今のところ ROM は version 1.20 のみサポートしています。
1.1.1.4 root 763: <q>
1.1.1.12! root 764: For LUNA-88K,
1.1.1.4 root 765: the ROM file is extracted from 0x41000000-0x4103ffff (256KB).
1.1.1.11 root 766: For now, only version 1.20 is supported.</q>
1.1.1.2 root 767: _EOM_
768: );
769:
1.1.1.3 root 770: config_item("ram-size = <i>integer</i>", <<<_EOM_
1.1.1.2 root 771: 搭載する RAM サイズを MB 単位で指定します。
1.1.1.6 root 772: LUNA-I のデフォルトは 16MB です。
773: 16MB 未満は 4MB 単位で、
774: 16MB 以上は 255MB まで 1MB 単位で指定できます
775: (ちなみに NetBSD/luna68k の起動には最低でも 8MB 必要です)。
1.1.1.12! root 776: LUNA-88K のデフォルトは 64MB です。
1.1.1.6 root 777: 64MB 未満は 16MB 単位で、
778: 64MB 以上は暫定で 255MB まで 1MB 単位で指定できます。
1.1.1.5 root 779: <q>Specifies the RAM size in MB.
1.1.1.6 root 780: On LUNA-I, the default is 16MB.
781: If the size is less than 16MB, you can specify in 4MB unit.
782: If larger, you can specify up to 255MB in 1MB unit.
783: By the way, NetBSD/luna68k needs at least 8MB to boot.
1.1.1.12! root 784: On LUNA-88K, the default is 64MB.
1.1.1.6 root 785: If the size is less than 64MB, you can specify in 16MB unit.
1.1.1.11 root 786: If larger, you can specify up to tentative 255MB in 1MB unit.</q>
1.1 root 787: _EOM_
788: );
789:
1.1.1.12! root 790: config_item("rtc-epoch-year = <i>integer</i>", <<<_EOM_
! 791: RTC の基準年を指定します。
! 792: デフォルトは 1970年です。
! 793: NetBSD/luna68k、OpenBSD/luna88k はいずれも基準年を 1970年としていますので、
! 794: デフォルトのままで構いません。
! 795: ゲスト OS に 4.4BSD を使用する際は 1900 を指定します。
! 796: <q>Specifies the RTC epoch year.
! 797: The default is 1970.
! 798: Since both NetBSD/luna68k and OpenBSD/luna88k use 1970 as epoch year,
! 799: there is no need to touch this value.
! 800: If you boot 4.4BSD on LUNA-I as the guest OS, specify 1900.</q>
! 801: _EOM_
! 802: );
! 803:
1.1.1.7 root 804: config_item("show-statuspanel = <i>integer</i>", <<<_EOM_
805: ステータスパネルを表示するかどうかを指定します。
806: 0 なら非表示、1 なら表示です。
807: 起動後はメニューから変更可能です。
808: <q>Specifies whether to display the status panel or not.
809: If 0, it is hidden; if 1, it is shown.
1.1.1.11 root 810: You can change it on GUI menu after boot.</q>
1.1.1.7 root 811: _EOM_
812: );
813:
1.1.1.9 root 814: config_item("spc0-id<i>N</i>-image = <i>devtype</i>[,<i>path</i>]", <<<_EOM_
815: SCSI デバイスとイメージを指定します。キーの <i>N</i> には 0 から 7 が入ります。
816: ただし ID 7 は本体が使用しますので指定しないでください。
817: 値はデバイス種別 <i>devtype</i> とディスクイメージパス <i>path</i>
818: を "<tt>,</tt>"(カンマ) で区切って並べた形式です。
819: デバイス種別 <i>devtype</i> は以下のいずれかです。
1.1.1.2 root 820: <q>
1.1.1.9 root 821: Specifies SCSI device and image. <i>N</i> in the key is 0 to 7.
1.1.1.2 root 822: But don't specify ID 7 because the host uses it.
823: The value is in a form of device type <i>devtype</i> and
1.1.1.9 root 824: the disk image path <i>path</i> separated by "<tt>,</tt>"(comma).
1.1.1.11 root 825: <i>devtype</i> can be one of the following:</q>
1.1.1.9 root 826: <ul>
827: <li><tt>hd</tt> … HD drive
828: <li><tt>cd</tt> … CD-ROM drive
829: <li><tt>mo</tt> … MO drive
830: </ul>
831:
832: <p>
833: <i>devtype</i> が <tt>hd</tt> なら <i>path</i> は省略できません。
834: <i>devtype</i> が <tt>cd</tt> か <tt>mo</tt> なら <i>path</i> は省略可能です。
835: イメージパスが相対パスなら VM ディレクトリからの相対パスになります。
836: <q>
837: If <i>devtype</i> is <tt>hd</tt>, <i>path</i> cannot be ommitted.
838: If <i>devtype</i> is <tt>cd</tt> or <tt>mo</tt>, <i>path</i> can be ommitted.
1.1.1.11 root 839: If the <i>path</i> is relative path, it is from the VM directory.</q>
1.1.1.2 root 840:
1.1 root 841: <p>
1.1.1.9 root 842: 例えば、nono.cfg と同じディレクトリに置いた sd0.img を
843: 起動 HDD ディスクイメージとして使い
844: (LUNA では通常 ID 6 をプライマリ HDD に割り当てます)、
845: ID 5 に同じディレクトリの install.iso をセットした CD ドライブを、
846: ID 4 に起動時メディアなしの MO ドライブを接続する場合は次のようになります。
847: <q>For example, if you use a harddisk image sd0.img placed in the same
848: directory as nono.cfg
849: (LUNA usually assigns ID 6 to the primary HDD),
850: ID 5 for CD-ROM drive that loads install.iso in the same directory,
851: and ID 4 for MO drive without media on boot,
1.1.1.2 root 852: write as following:</q>
1.1 root 853: <blockquote><pre>
1.1.1.9 root 854: spc0-id6-image = hd,sd0.img
855: spc0-id5-image = cd,install.iso
856: spc0-id4-image = mo
1.1 root 857: </pre></blockquote>
858: _EOM_
859: );
860:
1.1.1.4 root 861: config_item("spc0-id<i>N</i>-seektime = <i>integer</i>", <<<_EOM_
862: 指定の SCSI HDD の平均シークタイムを msec 単位で指定します。
863: 現在のデフォルトは <tt>0</tt> です (S・S・D!! S・S・D!!)。
864: 16 程度を指定すると幾分往時に思いを馳せることが出来るかもしれませんが、
865: 今の所あまり安定していません。
866: <q>Specifies the average seek time of specified SCSI HDD in msec.
867: Currently, the default value is <tt>0</tt>
868: (This may be something like SSD :-).
869: If you specify about 16 or so, you can feel nostalgic,
1.1.1.11 root 870: but this feature is still unstable.</q>
1.1.1.4 root 871: _EOM_
872: );
873:
1.1.1.9 root 874: config_item("spc0-id<i>N</i>-writeignore = <i>integer</i>", <<<_EOM_
875: 指定の SCSI HD デバイスへの書き込みを無視するかどうか指定します。
1.1 root 876: <tt>0</tt> なら通常動作(書き込みを行う)です。
877: <tt>1</tt> なら書き込みコマンドは成功したように振る舞いますが実際には
878: ディスクイメージに一切書き戻しません。
879: fsck を気にせずカーネルのデバッグとかを行いたい場合にはどうぞ。
880: 何が起きるか意味が分からない人は指定しないでください。
881: デフォルトは <tt>0</tt> です。
1.1.1.9 root 882: <q>Specifies whether nono ignores writing to SCSI HD devices.
1.1.1.2 root 883: <tt>0</tt> means normal operation (writes to the devices).
1.1.1.6 root 884: If <tt>1</tt> is specified,
1.1.1.2 root 885: nono will not actually write back to the disk image
886: even though the write command is succeeded.
887: nono's SCSI devices acts as
888: write command is successfully done but it never writes back
889: to the actual disk image.
890: This is useful for kernel debugging because it does not require fsck
891: after the kernel hangs.
892: But don't use this flag if you don't understand this paragraph.
1.1.1.9 root 893: The default value is <tt>0</tt>.</q>
894: <p>
895: ちなみに、メディアを書き込み禁止にしたい場合はこれではなく、
896: イメージファイルの書き込み権を落としてください。
897: <q>By the way, if you want to make the media write-protected,
898: clear the write permission from the image file
899: (instead of this setting).</q>
900: _EOM_
901: );
902:
903: config_item("spc0-id<i>N</i>-writeprotect = <i>integer</i>", <<<_EOM_
904: 古いオプションです。
905: 代わりに <tt>spc0-id<i>N</i>-writeignore</tt> を使ってください。
906: このオプションは開発用です。
907: <q>Obsolete.
908: Use <tt>spc0-id<i>N</i>-writeignore</tt> instead.
1.1.1.11 root 909: This option is for developers.</q>
1.1 root 910: _EOM_
911: );
912: ?>
913: </dl>
914: </div>
915:
916:
1.1.1.7 root 917: <a name="aboutvm"></a>
1.1.1.10 root 918: <h4>4. VM について <q>About VM</q></h4>
919: <h5>4.1. ステータスパネル <q>Status Panel</q></h5>
1.1.1.7 root 920: <div class="main">
921: ステータスパネル中央にあるパフォーマンスメータのアイコンは
922: 高速モードの状態を表示しています。
923: ダブルクリックすると高速/等速モードの指定を切り替えることができます。
924: <q>The performance meter's icon at the center of the status panel
925: shows the VM speed status.
1.1.1.11 root 926: You can switch full speed / syncronized mode by double-clicking
927: on this icon.</q>
1.1.1.7 root 928: <table>
929: <tr><td valign=top>
930: <image src="image/sp-ffmark0.png" style="padding:0.5ex; background-color:white">
931: <td valign=top>…
932: <td valign=top>
933: マークなしの場合、ユーザが等速モードを指定していて、等速モードで実行中です。
934: <q>When no icons are displayed,
935: the user has specified syncronized mode and
936: the VM is running in synchronized mode.</q>
937: <tr><td valign=top>
1.1.1.11 root 938: <image src="image/sp-ffmark2.png" style="padding:0.5ex; background-color:white">
1.1.1.7 root 939: <td valign=top>…
940: <td valign=top>
1.1.1.11 root 941: 三角3つの場合、ユーザが高速モードを指定していて、高速モードで実行中です。
1.1.1.8 root 942: 高速モード中はパーセントではなく何倍速で動作しているかを表します。
1.1.1.11 root 943: <q>When an icon (three triangles) is displayed,
1.1.1.7 root 944: the user has specified full speed mode and
1.1.1.11 root 945: the VM is running in full speed mode.
1.1.1.7 root 946: <tr><td valign=top>
1.1.1.11 root 947: <image src="image/sp-ffmark1.png" style="padding:0.5ex; background-color:white">
1.1.1.7 root 948: <td valign=top>…
949: <td valign=top>
1.1.1.11 root 950: 三角2つの場合、ユーザが高速モードを指定していて、等速モードで実行中です。
951: 以下のいずれかの状態で起きます。
952: <q>When an icon (two triangles) is displayed,
1.1.1.7 root 953: the user has specified full speed mode and
1.1.1.11 root 954: the VM is running in synchronized mode.
955: This will happen when any of the following occurs:</q>
956: <ul>
957: <li>キー押下中(後述)あるいはキーボードブザー発声中
958: <q>When any keys are pressed (see below),
959: or the keyboard buzzer is sounding.
960: <li>STOP instruction on m68k.
961: <li>pseudo STOP state on m88k.
962: </ul>
1.1.1.7 root 963: </table>
964: </div>
965:
1.1.1.10 root 966: <h5>4.2. キー入力モード <q>Key input mode</q></h5>
967: <div class="main">
968: LUNA のキーボードは通常日本語キーボードです
969: (英語キーボードも存在するようですが…)。
970: そのため、ホストが日本語キーボードの場合とそうでない場合のために
971: 2つの入力モードを用意しています。
972: どちらも一長一短があります。
973: <q>Most LUNAs have the Japanese keyboard
974: (though I ever heard there are the US keyboard...).
975: So nono provides two input modes
976: for Japanese keyboard users and non Japanese keyboard users.
977: Both have advantages and disadvantages.</q>
978: <p>
979: JP キーボードモードは、ホストが日本語キーボードであることを前提に
980: 対応するキーの押下、開放をその都度 VM に入力します。
981: メリットとしては動作が実機に近くなり、
982: 特にキーリピート(をハードウェアが行わないこと)も忠実に再現可能です。
983: デメリットは ALT + TAB やアクセラレータキーでメニューを開く場合などに
984: キー入力が残ることがあることです
985: (キーを押した後でフォーカスが外れるとキーを離したことが
986: アプリケーションに通知されないため)。
987: またホストが日本語キーボードでなければ使いづらいです。
988: <q>JP keyboard mode assumes that the host uses the Japanese keyboard.
989: Each time you presses and releases a key,
990: nono sends the corresponding key-pressed or key-released to the VM.
991: One advantage is that it's close to the real machine behavior,
992: and another is that it can reproduce
993: the LUNA keyboard itself does not perform a key repeat.
994: On the other hand,
995: one disadvantage is that key sometimes remains pressed,
996: especially when you enter ALT + TAB to switch the application
997: or enter accelerator key to open the menu
998: (If the application loses the focus after the key is pressed,
999: the application will not receive the subsequent key release).
1000: And another disadvantage is that
1.1.1.11 root 1001: it will be hard to use for non Japenese keyboard users.</q>
1.1.1.10 root 1002: <p>
1003: 一方、キャラクタ入力モードは、ホストから入力された「文字」を
1004: 再び LUNA のキーコードに解釈し直して VM に入力するモードです。
1005: 例えばゲスト OS に "@" を入力したい場合、
1006: US キーボードなら [SHIFT] + [2] を、
1007: JP キーボードなら [@] キーを押しますが、
1008: どちらも VM には [@] キーの押下、[@] キーの開放が連続して送られます。
1009: US キーボードで [SHIFT] を押したことは通知されません。
1010: 逆に "=" を入力したい場合、
1011: US キーボードなら [=] キーを、
1012: JP キーボードなら [SHIFT] + [-] を押しますが、
1013: どちらも VM には
1014: [SHIFT]押下 → [-]押下 → [-]開放 → [SHIFT]開放のシーケンスが送られます。
1015: このようにホストキーボードのレイアウトによらず、
1016: 入力したい文字が入力できるようになり、
1017: 通常のタイピングで困ることはないと思います。
1018: デメリットは、通常の文字入力以外のタイピングはほぼ出来ないことです。
1019: [SHIFT] キーを押したままにすることや、
1020: 文字が入力できないキーの組み合わせは入力出来ません。
1021: もう一つのデメリットはキーリピート(をハードウェアが行わないこと)が再現できず、
1022: ホスト側のキーリピートが効いてしまうことです
1023: (本来キーリピートが動作しない ROM やブートローダでもキーリピートが効くことは
1024: 一般ユーザからはメリットに感じられるかも知れませんが)。
1025: <q>In contrast, in the character mode, when you type a character,
1026: nono re-converts it into the LUNA's key code and sends it to the VM.
1027: For example if you want to type "@" in the guest OS,
1028: you would press [SHIFT] + [2] on the US keyboard or [@] on the JP keyboard.
1029: In both cases, the sequence of
1030: [@]-pressed and [@]-released will be sent to the VM.
1031: Note that the fact that you pressed [SHIFT] key on the US keyboard
1032: will not be sent to the VM.
1033: Another example, if you want to type "=",
1034: you would press [=] on the US keyboard or [SHIFT] + [-] on the JP keyboard.
1035: In both cases, the sequence of
1036: [SHIFT]-pressed, [-]-pressed, [-]-released, and [SHIFT]-released
1037: will be sent to the VM.
1038: Thus, you can type what character you want to type,
1039: regardless of your keyboard layout.
1040: Of course there are some disadvantages.
1041: Firstly, it's hard to type any special characters,
1042: for example, you can not type any key conbinations
1043: that don't generate a character.
1044: Or you can not hold [SHIFT] key pressed.
1045: Secondly, the key repeat works (by the host),
1046: even though it should not work as a correct emulation
1047: (Although some of you may feel it an advantage).</q>
1048: </div>
1049:
1050: <h5>4.3. キャラクタ入力モードのキーコード対応表
1051: <q>Keycode table in the character mode</h5>
1052: <div class="main">
1053: キャラクタ入力モードでの、ホストから入力した文字と
1054: VM に送信されるキーの対応は次の通りです。
1055: ファンクションキーとカーソルキーは文字ではありませんが
1056: 特別に対応しています。
1057: HostChar が N/A で示してあるキーはソフトウェアキーボードからのみ入力できます。
1058: <q>The following table shows the correspondence between
1059: the character that typed from the host
1060: and the key that will be sent to the VM.
1061: nono can recognize the function keys and arrow keys.
1062: The keys where the HostChar is N/A can
1063: only be typed from the software keyboard window.</q>
1064: <p>
1065: <center>
1066: <style type="text/css">
1067: .keytable-whole {
1068: display: inline-block;
1069: vertical-align: top;
1070: border: solid 1px;
1071: }
1072: .keytable-middle {
1073: margin-left: 1em;
1074: margin-right: 1em;
1075: }
1076:
1077: .keytable-head {
1078: text-align: left;
1079: border-bottom: solid 1px;
1080: }
1081: .keytable-headl {
1082: padding-right: 1em;
1083: }
1084:
1085: .keytable-tdl {
1086: padding-right: 1em;
1087: }
1088: .keytable-tdr {
1089: }
1090: </style>
1091: <?php
1092: $str = <<<__EOM__
1093: <tt>a</tt> 〜 <tt>z</tt> [A] 〜 [Z]
1094: <tt>0</tt> 〜 <tt>9</tt> [0] 〜 [9]
1095: SPACE [SPACE]
1096: <tt>-</tt> [-]
1097: <tt>^</tt> [^]
1098: <tt>\</tt> [\]
1099: <tt>@</tt> [@]
1100: <tt>[</tt> [[]
1101: <tt>;</tt> [;]
1102: <tt>:</tt> [:]
1103: <tt>]</tt> []]
1104: <tt>,</tt> [,]
1105: <tt>.</tt> [.]
1106: <tt>/</tt> [/]
1107: <tt>^@</tt> [CTRL]+[@]
1108: <tt>^A</tt> 〜 <tt>^Z</tt> [CTRL]+[A] 〜 [CTRL]+[Z]
1109: <tt>^[</tt> [ESC]
1110: <tt>^\</tt> [CTRL]+[\]
1111: <tt>^]</tt> [CTRL]+[]]
1112: <tt>^^</tt> [CTRL]+[^]
1113: <tt>^_</tt> [CTRL]+[_]
1114: <tt>^H</tt> [BS]
1115: <tt>^I</tt> [TAB]
1116: <tt>^M</tt> [Enter]
1117:
1118: <tt>A</tt> 〜 <tt>Z</tt> [SHIFT]+[A] 〜 [SHIFT]+[Z]
1119: <tt>!</tt> [SHIFT]+[1]
1120: <tt>"</tt> [SHIFT]+[2]
1121: <tt>#</tt> [SHIFT]+[3]
1122: <tt>$</tt> [SHIFT]+[4]
1123: <tt>%</tt> [SHIFT]+[5]
1124: <tt>&</tt> [SHIFT]+[6]
1125: <tt>'</tt> [SHIFT]+[7]
1126: <tt>(</tt> [SHIFT]+[8]
1127: <tt>)</tt> [SHIFT]+[9]
1128: <tt>=</tt> [SHIFT]+[-]
1129: <tt>~</tt> [SHIFT]+[^]
1130: <tt>|</tt> [SHIFT]+[\]
1131: <tt>`</tt> [SHIFT]+[@]
1132: <tt>{</tt> [SHIFT]+[[]
1133: <tt>+</tt> [SHIFT]+[;]
1134: <tt>*</tt> [SHIFT]+[:]
1135: <tt>]</tt> [SHIFT]+[]]
1136: <tt><</tt> [SHIFT]+[,]
1137: <tt>></tt> [SHIFT]+[.]
1138: <tt>?</tt> [SHIFT]+[/]
1139: <tt>_</tt> [SHIFT]+[_]
1140:
1141: F1 〜 F10 [PF1] 〜 [PF10]
1142: ↑ [↑]
1143: ← [←]
1144: → [→]
1145: ↓ [↓]
1146: N/A [確定]
1147: N/A [前面]
1148: N/A [CAP]
1149: N/A [かな]
1150: N/A [変換]
1151: N/A [消去]
1152: N/A [呼出]
1153: N/A [文節←]
1154: N/A [文節→]
1155: N/A Numpad[0]〜[9]
1156: N/A Numpad[+]
1157: N/A Numpad[-]
1158: N/A Numpad[*]
1159: N/A Numpad[/]
1160: N/A Numpad[=]
1161: N/A Numpad[.]
1162: N/A Numpad[Enter]
1163: __EOM__;
1164: $table = array();
1165: $table[0] = array();
1166: $table[1] = array();
1167: $table[2] = array();
1168: $i = 0;
1169: foreach (split("\n", $str) as $s) {
1170: if ($s == "") {
1171: $i++;
1172: continue;
1173: }
1174: $s = preg_replace("/^\t+/", "", $s);
1175: list ($hkey, $gkey) = preg_split("/\t+/", $s);
1176: $table[$i][] = array($hkey, $gkey);
1177: }
1178:
1179: for ($j = 0; $j < count($table); $j++) {
1180: switch ($j) {
1181: case 0: $classname = "left"; break;
1182: case 1: $classname = "middle"; break;
1183: case 2: $classname = "right"; break;
1184: }
1185: print "<table class='keytable-whole keytable-${classname}'";
1186: print " cellspacing=0 cellpadding=1>\n";
1187: print "<tr>";
1188: print "<th class='keytable-head keytable-headl'>HostChar";
1189: print "<th class='keytable-head keytable-headr'>GuestKey\n";
1190: for ($i = 0; $i < count($table[$j]); $i++) {
1191: list ($h, $g) = $table[$j][$i];
1192: print "<tr>";
1193: print "<td class='keytable-tdl'>{$h}";
1194: print "<td class='keytable-tdr'>${g}\n";
1195: }
1196: print "</table>\n";
1197: }
1198: ?>
1199: </center>
1200: </div>
1201:
1202: <h5>4.4. JP キーボードモードのキーコード対応表
1203: <q>Keycode table in the JP keyboard mode</q></h5>
1204: <div class="main">
1205: JP キーボードモードでの、ホストキーと VM に送信されるキーの対応は次の通りです。
1206: HostKey が N/A で示してあるキーは
1207: ソフトウェアキーボードからのみ入力出来ます。
1208: <q>The following table shows the correspondence between
1209: the host key and the guest key.
1210: The keys where the HostKey is N/A can only be enter from
1211: the software keyboard window.</q>
1212: <p>
1213: <center>
1214: <?php
1215: $str = <<<__EOM__
1216: [0] 〜 [9] [0] 〜 [9]
1217: [A] 〜 [Z] [A] 〜 [Z]
1218: [-] [-]
1219: [^] [^]
1220: [\] [\]
1221: [@] [@]
1222: [[] [[]
1223: [;] [;]
1224: [:] [:]
1225: []] []]
1226: [,] [,]
1227: [.] [.]
1228: [/] [/]
1229: [_] [_]
1230:
1231: [ESC] [ESC]
1232: [TAB] [TAB]
1233: [CTRL] [CTRL]
1234: [BS] [BS]
1235: [Enter] [Enter]
1236: [F1] 〜 [F10] [PF1] 〜 [PF10]
1237: [DEL] Numpad[DEL]
1238: Numpad[0]〜[9] Numpad[0]〜[9]
1239: Numpad[+] Numpad[+]
1240: Numpad[-] Numpad[-]
1241: Numpad[*] Numpad[*]
1242: Numpad[/] Numpad[/]
1243: Numpad[=] Numpad[=]
1244: Numpad[.] Numpad[.]
1245: Numpad[Enter] Numpad[Enter]
1246:
1247: [SHIFT-L] [SHIFT-L]
1248: [SHIFT-R] [SHIFT-R]
1249: [↑] [↑]
1250: [←] [←]
1251: [→] [→]
1252: [↓] [↓]
1253: N/A [確定]
1254: N/A [前面]
1255: N/A [CAP]
1256: N/A [かな]
1257: N/A [変換]
1258: N/A [消去]
1259: N/A [呼出]
1260: N/A [文節←]
1261: N/A [文節→]
1262: __EOM__;
1263: $table = array();
1264: $table[0] = array();
1265: $table[1] = array();
1266: $table[2] = array();
1267: $i = 0;
1268: foreach (split("\n", $str) as $s) {
1269: if ($s == "") {
1270: $i++;
1271: continue;
1272: }
1273: $s = preg_replace("/^\t+/", "", $s);
1274: list ($hkey, $gkey) = preg_split("/\t+/", $s);
1275: $table[$i][] = array($hkey, $gkey);
1276: }
1277:
1278: for ($j = 0; $j < count($table); $j++) {
1279: switch ($j) {
1280: case 0: $classname = "left"; break;
1281: case 1: $classname = "middle"; break;
1282: case 2: $classname = "right"; break;
1283: }
1284: print "<table class='keytable-whole keytable-${classname}'";
1285: print " cellspacing=0 cellpadding=0>\n";
1286: print "<tr>";
1287: print "<th class='keytable-head keytable-headl'>HostKey";
1288: print "<th class='keytable-head keytable-headr'>GuestKey\n";
1289: for ($i = 0; $i < count($table[$j]); $i++) {
1290: list ($h, $g) = $table[$j][$i];
1291: print "<tr>";
1292: print "<td class='keytable-tdl'>{$h}";
1293: print "<td class='keytable-tdr'>${g}\n";
1294: }
1295: print "</table>\n";
1296: }
1297: ?>
1298: </center>
1299: </div>
1300:
1301: <h5>4.5. キーリピート <q>Key Repeat</q></h5>
1.1.1.7 root 1302: <div class="main">
1303: LUNA では、キーボードがハードウェア側でキーリピートを行わず、
1304: ソフトウェア(OS など)がキーリピートの処理を行います。
1305: そのため、キーリピートを実装していない LUNA の PROM や
1306: NetBSD/luna68k のブートローダではキーリピートは起きず、
1307: キーリピートを実装している NetBSD/luna68k カーネルではキーリピートが起こせます。
1.1.1.8 root 1308: キーリピートを起こす間隔をゲストのソフトウェアが測定しているということは、
1.1.1.7 root 1309: VM が高速動作するとキーリピートもそれに合わせて発生することになり、
1310: これをホスト側から防ぐ手段はありません。
1311: そこで nono ではキー入力が発生している間
1312: (キーが一つでも押されてからキーが全て離されるまでの間)、
1313: 高速モードが指示されていても VM を一時的に等速モードに落として実行します。
1314: 上記のアイコンがそれを区別しているのはこのためです。
1315: そのため、何らかの理由でキーが入りっぱなしになった場合
1316: (ALT + TAB やアクセラレータキーでメニューを開くと起きがちです)
1317: 高速モードが抑制されたままということが起きえます。
1318: その場合はソフトウェアキーボードからキー入力を解除するなどしてください。
1.1.1.10 root 1319: <q>On LUNA,
1.1.1.7 root 1320: key repeat is done by software(OS), not by the keyboard hardware.
1321: For this reason,
1322: key repeat doesn't occur on LUNA's PROM or NetBSD/luna68k's bootloader
1323: that don't implement it, and
1324: key repeat occurs on NetBSD/luna68k kernel that implements it.
1.1.1.8 root 1325: Since the timing of key repeat is measured by the guest software,
1.1.1.7 root 1326: if the VM is running faster than the real,
1327: the key repeat will occur faster, too.
1328: The host application doesn't have the way to avoid it.
1329: Therefore, nono will temporarily suppress the full speed mode
1330: while any keys are pressed.
1331: That is why the above-mentioned icon distinguishes them.
1.1.1.8 root 1332: If keys continue to be pressed for some reasons,
1.1.1.7 root 1333: the VM also continues to run syncronized mode.
1.1.1.11 root 1334: In this case, you can resolve it by using the software keyboard window.</q>
1.1.1.7 root 1335: </div>
1336:
1337:
1338: <a name="tryit"></a>
1.1.1.10 root 1339: <h4>5. 実行してみる <q>Try it</q></h4>
1340: <h5>5.1. NetBSD/luna68k を実行してみる <q>Try NetBSD/luna68k</q></h5>
1.1 root 1341: <div class="main">
1.1.1.8 root 1342: つついさんが NetBSD/luna68k 9.2 の liveimage を用意されています。
1343: <q>Tsutsui-san has provided a liveimage of NetBSD/luna68k 9.2.</q>
1344: <dl>
1.1.1.11 root 1345: <dd><a href="https://twitter.com/tsutsuii/status/1436381589211017217"
1346: >https://twitter.com/tsutsuii/status/1436381589211017217</a><br>
1.1.1.8 root 1347: </dl>
1348: ここではこれを起動してみます。<q>Let's try it.</q>
1.1.1.2 root 1349: <br>
1350: <ol>
1351: <li>どこかに nono 用のディレクトリを用意し(例えば ~/nono/)、
1.1 root 1352: その中に VM ディレクトリを用意します (例えば ~/nono/luna/)。
1.1.1.3 root 1353: <q>Create a directory somewhere for nono (for example ~/nono/),
1.1.1.8 root 1354: and create subdirectories for individual VMs in it
1355: (for example ~/nono/luna/).</q>
1.1 root 1356:
1.1.1.3 root 1357: <li>以下のリンクからイメージファイルをダウンロードして展開し、
1.1.1.2 root 1358: VM ディレクトリ ~/nono/luna/ に置きます。
1.1.1.3 root 1359: <q>Download imagefile from the following link,
1.1.1.7 root 1360: extract it and place it in the VM directory, ~/nono/luna/.</q>
1.1.1.3 root 1361: <blockquote>
1.1.1.11 root 1362: <a href="http://teokurebsd.org/netbsd/liveimage/20210910-luna68k/"
1363: >http://teokurebsd.org/netbsd/liveimage/20210910-luna68k/</a>
1.1.1.3 root 1364: </blockquote>
1.1.1.2 root 1365:
1.1.1.8 root 1366: <li>以下の内容の設定ファイル nono.cfg を VM ディレクトリ ~/nono/luna/
1367: に作成します。
1368: ここでは説明を簡単にするためネットワークなしにしていますが、
1369: ネットワーク設定は必要に応じて行ってください。
1.1.1.7 root 1370: <q>Create a configuration file nono.cfg in the VM directory, ~/nono/luna/,
1.1.1.8 root 1371: with following contents.
1372: By the way, to simplify the explanation, we assume there is no network here.
1373: However, please configure the network if necessary.</q>
1.1.1.2 root 1374: <blockquote class="file"><pre>
1375: vmtype = luna
1.1.1.11 root 1376: spc0-id6-image = hd,liveimage-luna68k-with-packages-20210910.img
1.1.1.8 root 1377: hostnet-driver = none
1.1.1.2 root 1378: </pre></blockquote>
1.1.1.8 root 1379:
1.1.1.2 root 1380: <li><tt>nono -c ~/nono/luna</tt> で起動します
1381: (VM ディレクトリに自動的に NVRAM.DAT が作られます)。
1382: <q>Run as <tt>nono -c ~/nono/luna</tt>.
1.1.1.4 root 1383: (NVRAM.DAT will be created automatically in the VM directory)</q>
1.1.1.2 root 1384: <li>Emulated ROM Monitor が起動するので、
1385: 初回は以下のように入力すると NetBSD が起動します。
1386: <q>The emulated ROM Monitor will be executed.
1387: Then, only for the first time,
1388: entering the following can boot NetBSD.</q>
1.1.1.8 root 1389: <blockquote><pre>
1390: k⏎
1391: ⏎
1392: ⏎
1393: d⏎
1394: boot⏎
1395: g⏎
1396: x⏎
1397: </pre></blockquote>
1398: 画面はこんな感じのはずです (太字が入力部分)。
1399: <q>You will see a screen like this. The bold text indicates
1400: the characters you need to enter.</q>
1.1.1.2 root 1401: <blockquote class="file"><pre>
1.1.1.11 root 1402: NONO <?=$nono_ver?> Emulated ROM Monitor for LUNA-I
1.1.1.8 root 1403:
1404: ** NVRAM Initialized.
1405:
1406: ><b>k⏎</b>
1407: controller: dk ?<b>⏎</b>
1408: drive unit: 0 ?<b>⏎</b>
1409: partition : c ?<b>d⏎</b>
1410: filename : vmunix ?<b>boot⏎</b>
1411: ><b>g⏎</b>
1412: Loaded. Entry point = $00700000
1413: ><b>x⏎</b>
1.1.1.2 root 1414: </pre></blockquote>
1415: この内容は NVRAM.DAT に記録されているので次回以降は直接 NetBSD が起動します。
1.1.1.7 root 1416: <q>The information you have just entered is recorded in the NVRAM,
1.1.1.2 root 1417: so next time it boots NetBSD automatically.</q>
1.1.1.8 root 1418: <li>初回起動時、
1419: Updating fontconfig cache はあほみたいに時間がかかりますが、
1420: nono がハングアップしてるわけではありません(>_<)。
1421: また初回ログイン時めちゃくちゃ重たいですが、
1422: これはバックグラウンドで makemandb が動くためで
1423: nono のせいではありません(>_<)。
1424: <q>At the first boot, you will see the console stops after printing
1425: "Updating fontconfig cache".
1426: This is because the infamous fontconfig takes very looooong time.
1427: nono would not have hang-up.
1428: In addition, after the first login, you will feel it's too heavy.
1429: This is because the infamous makemandb(8) runs heavily in the background
1430: for a looooong time.
1431: It's very sad to me that these two accidents which are far from the ideal
1.1.1.12! root 1432: are the first experiences of newcomers.</q>
1.1.1.8 root 1433:
1434: <li>終了する時は root
1435: ユーザで “<tt>shutdown -p now</tt>” を実行してください。
1436: LUNA はソフトウェアから電源オフでき、
1437: VM の電源オフで nono も終了します。
1438: <q>To quit, type “<tt>shutdown -p now</tt>” as the root user.
1439: LUNA can be powered off by software,
1440: and nono will terminate when the VM is powered off.</q>
1441: </ol>
1442: </div>
1443:
1.1.1.10 root 1444: <h5>5.2. OpenBSD/luna88k を実行してみる <q>Try OpenBSD/luna88k</q></h5>
1.1.1.8 root 1445: <div class="main">
1.1.1.12! root 1446: あおやまさんが OpenBSD/luna88k 7.0 の liveimage を用意されています。
! 1447: <q>Aoyama-san has provided a liveimage of OpenBSD/luna88k 7.0.</q>
1.1.1.8 root 1448: <dl>
1.1.1.12! root 1449: <dd><a href="https://twitter.com/ao_kenji/status/1473611893386661888"
! 1450: >https://twitter.com/ao_kenji/status/1473611893386661888</a>
1.1.1.8 root 1451: </dl>
1452: ここではこれを起動してみます。<q>Let's try it.</q>
1453: <br>
1454: <ol>
1455: <li>どこかに nono 用のディレクトリを用意し(例えば ~/nono/)、
1456: その中に VM ディレクトリを用意します (例えば ~/nono/luna88k/)。
1457: <q>Create a directory somewhere for nono (for example ~/nono/),
1458: and create subdirectories for individual VMs in it
1459: (for example ~/nono/luna88k/).</q>
1460:
1.1.1.12! root 1461: <li>以下のリンクから liveimage-luna88k-raw-20211221.img.gz
1.1.1.8 root 1462: をダウンロードして展開し、
1463: VM ディレクトリ ~/nono/luna88k/ に置きます。
1.1.1.12! root 1464: <q>Download liveimage-luna88k-raw-20211221.img.gz from the following link,
1.1.1.8 root 1465: extract it and place it in the VM directory, ~/nono/luna88k/.</q>
1466: <blockquote>
1467: <a href="http://www.nk-home.net/~aoyama/liveimage/"
1468: >http://www.nk-home.net/~aoyama/liveimage/</a>
1469: </blockquote>
1470:
1471: <li>以下の内容の設定ファイル nono.cfg を VM ディレクトリ ~/nono/luna88k/
1472: に作成します。
1473: ここでは説明を簡単にするためネットワークなしにしていますが、
1474: ネットワーク設定は必要に応じて行ってください。
1475: <q>Create a configuration file nono.cfg in the VM directory, ~/nono/luna88k/,
1476: with following contents.
1477: By the way, to simplify the explanation, we assume there is no network here.
1478: However, please configure the network if necessary.</q>
1479: <blockquote class="file"><pre>
1480: vmtype = luna88k
1.1.1.12! root 1481: spc0-id6-image = hd,liveimage-luna88k-raw-20211221.img
1.1.1.8 root 1482: hostnet-driver = none
1483: </pre></blockquote>
1484:
1485: <li><tt>nono -c ~/nono/luna88k</tt> で起動します
1486: (VM ディレクトリに自動的に NVRAM.DAT が作られます)。
1487: <q>Run as <tt>nono -c ~/nono/luna88k</tt>.
1488: (NVRAM.DAT will be created automatically in the VM directory)</q>
1489: <li>Emulated ROM Monitor が起動するので、
1490: 初回は以下のように入力すると OpenBSD が起動します。
1491: <q>The emulated ROM Monitor will be executed.
1492: Then, only for the first time,
1493: entering the following can boot OpenBSD.</q>
1494: <blockquote><pre>
1495: nvram boot_filename boot⏎
1496: y
1497: b⏎
1498: </pre></blockquote>
1499: 画面はこんな感じのはずです (太字が入力部分)。
1500: <q>You will see a screen like this. The bold text indicates
1501: the characters you need to enter.</q>
1502: <blockquote class="file"><pre>
1.1.1.11 root 1503: NONO <?=$nono_ver?> Emulated ROM Monitor for LUNA88K
1.1.1.8 root 1504:
1505: ** NVRAM Initialized.
1506:
1507: N><b>nvram boot_filename boot⏎</b>
1508: Update boot_filename : "vmunix" -> "boot" (Y/[N]):<b>y</b>
1509: Updated
1510: N><b>b⏎</b>
1511: </pre></blockquote>
1512: この内容は NVRAM.DAT に記録されているので次回以降は直接 OpenBSD が起動します。
1513: <q>The information you have just entered is recorded in the NVRAM,
1514: so next time it boots OpenBSD automatically.</q>
1515:
1516: <li>終了する時は root
1517: ユーザで “<tt>shutdown -p now</tt>” を実行してください。
1.1.1.12! root 1518: LUNA-88K はソフトウェアから電源オフでき、
1.1.1.8 root 1519: VM の電源オフで nono も終了します。
1520: <q>To quit, type “<tt>shutdown -p now</tt>” as the root user.
1.1.1.12! root 1521: LUNA-88K can be powered off by software,
1.1.1.8 root 1522: and nono will terminate when the VM is powered off.</q>
1.1.1.2 root 1523: </ol>
1.1 root 1524: </div>
1525:
1526:
1.1.1.8 root 1527:
1.1.1.7 root 1528: <a name="network"></a>
1.1.1.10 root 1529: <h4>6. ネットワーク設定例 <q>Example of network setup</q></h4>
1.1 root 1530: <div class=main>
1.1.1.8 root 1531: wm0 を持つ NetBSD ホストに tap(4) デバイスを用いて
1532: nono のゲスト OS を接続する場合の設定例です。
1533: <ol>
1534: <li>
1535: 設定ファイル nono.cfg に以下の行を追加します
1536: (と言いつつ NetBSD では書かなくてもデフォルトでこの動作になりますが)
1537: <q>Add the following line to configuration file, nono.cfg.
1538: (Although you don't need to write it since these are default behavior
1539: on NetBSD)</q>
1.1 root 1540: <blockquote class="file"><pre>
1.1.1.8 root 1541: hostnet-driver = tap
1542: hostnet-tap-devpath = auto
1.1 root 1543: </pre></blockquote>
1.1.1.8 root 1544:
1.1.1.5 root 1545: <li>デフォルトでは /dev/tap は一般ユーザからアクセスできないので、
1546: chmod で適当にパーミッションを与えます。
1547: 番号の付いていないほうの /dev/tap だけでいいです。
1548: sysinst 等で OS をアップグレードするとパーミッションが 600
1549: に戻るのがハマりポイントです。
1.1.1.8 root 1550: <q>By default, /dev/tap is only accessible to privileged user.
1551: You need to chmod /dev/tap (without unit number) appropriately.
1.1.1.11 root 1552: Note that upgrading using sysinst always reset the permission to 600.</q>
1.1.1.5 root 1553:
1554: <li>bridge(4) インタフェースを作成し、
1.1.1.8 root 1555: ホストの外部(物理)インタフェースをブリッジに追加しておきます。
1.1.1.5 root 1556: <q>Create a bridge(4) interface, and
1557: add your physical interface to the bridge.</q>
1.1 root 1558: <blockquote class="cons"><pre>
1.1.1.5 root 1559: # ifconfig bridge0 create
1.1 root 1560: # brconfig bridge0 add wm0
1561: </pre></blockquote>
1.1.1.8 root 1562: 常用するなら /etc の設定ファイルに書いておきましょう。
1563: <q>If you use it regularly,
1.1.1.5 root 1564: you can put configuration file into /etc.</q>
1565: <blockquote>
1566: /etc/ifconfig.bridge0
1567: <pre class=file>
1568: create
1569: up
1570: !/sbin/brconfig $int add wm0
1571: </pre>
1572: <pre class=cons>
1573: # /etc/rc.d/network restart
1574: </pre>
1575: </blockquote>
1576:
1577: <li>
1578: 一般ユーザに戻って、
1579: VM ディレクトリかその親ディレクトリに
1580: 次のような 2つのスクリプトを用意します。
1.1.1.8 root 1581: nono は tap(4) をオープンし、
1582: そのデバイス名を引数にこれらのスクリプトを呼びます。
1.1.1.5 root 1583: sudo の設定は別途行ってください。
1584: <q>Return to non-privileged user, and
1585: create following two scripts in the VM directory or its parent directory.
1.1.1.8 root 1586: nono will open tap(4) and
1587: invoke these scripts with the name of the device as an argument.
1.1.1.5 root 1588: In addition, you need to set up sudo separately.</q>
1.1 root 1589: <blockquote>
1590: nono-ifup
1591: <pre class=file>
1592: #!/bin/sh
1.1.1.5 root 1593: sudo /sbin/ifconfig $1 up
1594: sudo /sbin/brconfig bridge0 add $1
1.1 root 1595: </pre></blockquote>
1596:
1597: <blockquote>
1.1.1.5 root 1598: nono-ifdown
1.1 root 1599: <pre class=file>
1600: #!/bin/sh
1.1.1.5 root 1601: sudo /sbin/brconfig bridge0 delete $1
1602: sudo /sbin/ifconfig $1 down
1603: </pre></blockquote>
1604:
1605: <blockquote class="cons"><pre>
1606: % chmod +x nono-ifup nono-ifdown
1.1 root 1607: </pre></blockquote>
1608:
1.1.1.5 root 1609: <li>nono を起動し、
1610: メニューの「モニタ > ホスト > ホストネットワーク」を開いて
1.1.1.8 root 1611: HostNet Driver: tap になっていれば動いてるはずです。
1.1.1.5 root 1612: <q>Run nono,
1613: and open "Monitor > Host > Host Network" window from menu.
1.1.1.8 root 1614: It's OK if you can see "HostNet Driver: tap".</q>
1.1.1.5 root 1615:
1616: </ol>
1617:
1.1 root 1618: </div>
1619:
1.1.1.12! root 1620: <a name="knownissues"></a>
! 1621: <h4>7. 既知の問題 <q>Known Issues</q></h4>
! 1622: <div class="main">
! 1623: <ul>
! 1624: <li><span class="new">デバッガのコンソール入力で、
! 1625: バックスペースやカーソルキーの入力に対する表示が動作していません。
! 1626: <q>In debugger console, some special characters like backspace or cursor keys
! 1627: aren't printed correctly.</q>
! 1628: (since ver 0.3.0)</span>
! 1629: <li>ホストが VirtualBox (on Windows?) で、
! 1630: VirtualBox の「マウス統合」が有効にしている場合、
! 1631: nono の「マウスモード」でマウスポインタが正しく移動しません。
! 1632: <q>If the host OS is running on VirtualBox (on Windows?) and
! 1633: "Mouse integration" on VirtualBox is enabled,
! 1634: the mouse pointer will not move as expected in nono's Mouse Mode.</q>
! 1635: (2021/12/30)
! 1636:
! 1637: <li>Wayland の場合にウィンドウサイズが正しく設定されない場合があります。
! 1638: wxWidgets (3.0.5) のバグと思われます。
! 1639: <q>On Wayland, window size may be incorrect.
! 1640: This may be due to wxWidgets (3.0.5) bug.</q>
! 1641: (2021/12/30)
! 1642:
! 1643: <li>メインウィンドウの中央付近に nono のサブウィンドウや他のウィンドウが存在する場合、マウスモードに入れません。
! 1644: <q>If there are nono's sub windows or other windows near the center of
! 1645: the main window, you will not enter the mouse mode.</q> (since ver 0.0.2)
! 1646:
! 1647: </ul>
! 1648: </div>
1.1 root 1649:
1.1.1.9 root 1650: <a name="migrate"></a>
1.1.1.12! root 1651: <h4>8. 過去のバージョンからの移行方法 <q>How to migrate from old versions</q></h4>
1.1.1.9 root 1652: <div class="main">
1653: バージョンアップに伴い設定ファイル等に非互換が発生する場合があります。
1654: その場合は以下の移行方法を参照して設定ファイル等を更新してください。
1655: <q>Some versions may have incompatibilities in the configuration files, etc.
1656: In such case, you may need to upgrade it by referring the following link.</q>
1657: <ul>
1658: <li><a href="upgrade-0.2.0.html">From ver 0.1.x to ver 0.2.0</a>
1659: </ul>
1660: </div>
1.1.1.2 root 1661:
1.1.1.10 root 1662: <a name="changes"></a>
1.1.1.12! root 1663: <h4>9. 変更履歴 <q>Changes</q></h4>
1.1.1.10 root 1664: <div class="main">
1665: See <a href="changes.html">changes.html</a>.
1666: </div>
1667:
1.1.1.7 root 1668: <a name="license"></a>
1.1.1.12! root 1669: <h4>10. 連絡先、ライセンス等 <q>Contact, License, etc</q></h4>
1.1.1.10 root 1670:
1.1.1.12! root 1671: <h5>10.1. ライセンス <q>License</q></h5>
1.1.1.2 root 1672: <div class="main">
1673: See <a href="nono-license.txt">nono-license.txt</a>.
1674: </div>
1675:
1.1.1.12! root 1676: <h5>10.2. 連絡先 <q>Contact us</q></h5>
1.1.1.4 root 1677: <div class="main">
1678: バグ報告などは以下にお願いします。日本語でおk。
1679: <q>If you find any problems, please let me know.
1680: You may write in English.</q><br>
1681: <a href="https://github.com/isaki68k/nono-issue/issues"
1682: >https://github.com/isaki68k/nono-issue/issues</a>
1683: </div>
1684:
1.1.1.12! root 1685: <h5>10.3. パッチの提供について <q>About contributes</q></h5>
1.1.1.2 root 1686: <div class="main">
1687: パッチを提供してくださる場合は以下に同意したものとします。
1.1.1.12! root 1688: <q>If you provide a patch to nono, we assume that you agree the following
1.1.1.11 root 1689: conditions:</q>
1.1.1.2 root 1690: <ul>
1691: <li>成果物が nono のライセンスに従って運用あるいは配布されること。
1692: <q>All your work are operated or distributed under the nono license.</q>
1693: <li>ライセンスが将来変わる可能性があること。
1694: <q>The license may be changed in the future.</q>
1695: <li>著作部分に関して著作者人格権を行使しないこと。
1696: <q>Do not exercise your author's rights.</q>
1697: </ul>
1698: <ul>
1699: </div>
1700:
1.1.1.12! root 1701: <h5>10.4. Acknowledgements</h5>
1.1.1.2 root 1702: <div class="main">
1703: nono は以下の広告条項を含むソースコードを利用しています。
1704: <q>nono uses source code with the following advertising clause.</q>
1705: <blockquote>
1706: This product includes software developed by Gordon Ross<br>
1707: This product includes software developed by the University of California, Lawrence Berkeley Laboratory.<br>
1708: </blockquote>
1709: </div>
1710:
1.1 root 1711:
1712: <hr>
1.1.1.2 root 1713: nono project
1.1 root 1714: </body>
1715: </html>
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.