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