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