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