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