![[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);
17: --light-grey: rgb(200, 200, 203);
1.1.1.4 root 18:
19: --bg-grey: rgb(220, 220, 223);
1.1 root 20: }
21: body {
1.1.1.4 root 22: background-color: var(--bg-grey);
1.1 root 23: }
24: q {
25: color: var(--brown);
26: }
27: q:before {
28: content: "[";
29: }
30: q:after {
31: content: "]";
32: }
33: dt.dt-indent {
34: padding-left: 1ex;
35: }
36: .main {
37: margin-left: 1em;
38: }
39: .cons {
40: background-color: black;
41: color: white;
42: }
43: .file {
44: background-color: white;
45: color: black;
46: }
47: .strike {
48: color: var(--grey);
49: }
1.1.1.5 root 50: .strike > q {
51: color: var(--grey);
52: }
1.1 root 53: </style>
54: </head>
55: <body>
1.1.1.6 ! root 56: <h3>nono 0.1.4 (2020/11/20)</h3>
1.1 root 57:
58: nono は NetBSD とかで動作する OMRON LUNA-I とかのエミュレータです。
1.1.1.4 root 59: <q>nono is OMRON LUNA-I emulator runs on NetBSD and etc.</q>
1.1 root 60: <hr>
1.1.1.4 root 61:
62: <h4>はじめに <q>Introduction</q></h4>
63: <div class="main">
64: nono は NetBSD とかで動作する OMRON LUNA-I とかのエミュレータです。
65: LUNA88K は実験的サポートです、まだ動きません。
66: <q>
67: nono is OMRON LUNA-I emulator runs on NetBSD and etc.
68: LUNA88K is still experimental support and it does not work yet.
69: </q>
70: </div>
71:
1.1 root 72: <h4>ビルド方法 <q>How to build</q></h4>
73: <div class="main">
1.1.1.5 root 74: ビルドには以下が必要です。
75: NetBSD(pkgsrc) なら wxWidgets は pkgsrc/x11/wxGTK30 (OPTIONS:gtk2 推奨) です。
76: <q>The followings are required for build.
77: If you use NetBSD(pkgsrc),
78: wxWidgets is pkgsrc/x11/wxGTK30 (OPTIONS:gtk2 is recommended).</q>
79:
1.1 root 80: <ul>
1.1.1.2 root 81: <li>make (BSD make, not GNU make)
1.1.1.4 root 82: <li>C/C++ compiler which supports -std=c++14.
83: <br>
84: (For gcc, 7.4 works but 5.5 doesn't work, at least.
85: For clang, 7.0 and 8.0 works at least.)
1.1.1.2 root 86: <li>wxWidgets >= 3.0
87: <li>gettext
1.1 root 88: </ul>
1.1.1.2 root 89:
1.1.1.5 root 90: <p>
91: (NetBSD 以外でのビルドはサポートしていませんが)
92: Ubuntu 18.04 ではたぶん以下のパッケージが必要です。
93: <q>You may need the following packages on Ubuntu 18.04
94: (though we won't support non-NetBSD platform).</q>
95: </p>
96: <dl>
97: <dd>
98: bmake
99: build-essential
100: gettext
101: libbsd-dev
102: libedit-dev
103: libkqueue-dev
104: libwxgtk3.0-dev
105: zlib1g-dev
106: </dl>
107:
1.1.1.2 root 108: <p>
109: アーカイブを展開したら以下のようにビルドします。
110: configure には環境変数 CC、CXX でコンパイラを指定することが出来ます。
111: また wx-config が標準的な名前で提供されていないために見付けられない場合には
112: 環境変数 WX_CONFIG にパスを指定することが出来ます。
113: <q>Extract the archive and build as following.
114: You can specify C/C++ compiler using environment variable CC and CXX
115: if configure cannot find standard name suitable compiler.
116: Also, you can specify wx-config path using environment variable WX_CONFIG
117: if configure cannot find wx-config.</q>
1.1 root 118: <blockquote class="cons"><pre>
119: % ./configure
120: % make depend
121: % make
1.1.1.2 root 122: % su
123: # make install
1.1 root 124: </pre></blockquote>
1.1.1.2 root 125:
126: <p>
127: 2つの実行ファイルがインストールされます。
128: <tt>nono</tt> が GUI 版実行ファイル、
129: <tt>nono-cli</tt> がコマンドライン版です。
130: <q>Two executables will be installed.
131: <tt>nono</tt> is GUI executable and <tt>nono-cli</tt> is
132: command line executable.</q>
1.1 root 133:
134: </div>
135:
136:
137: <h4>コマンドラインオプション <q>Command Line Option</q></h4>
138: <div class="main">
139: <dl>
140: <dt class=dt-indent><tt>-A <i>file</i></tt></dt>
141: <dd>ホストの <tt><i>file</i></tt> をロードして実行します。
1.1.1.4 root 142: <tt><i>file</i></tt> が相対パスの場合カレントディレクトリからのパスになります。
1.1 root 143: ファイルが gzip 圧縮されていれば自動的に展開します。
144: (展開後の) ファイル形式は a.out (OMAGIC) か ELF で、
145: 実際にはブートローダとカーネル程度しか想定していません。
1.1.1.2 root 146: 設定ファイルの <tt>prom-image</tt> とともに指定されると
147: <tt>-A</tt> のほうが優先します。
148: <q>Loads and executes host's <tt><i>file</i></tt>.
1.1.1.4 root 149: If <tt><i>file</i></tt> is relative path,
150: it is path from the current directory.
1.1.1.2 root 151: If the file is gzip'd, it is automatically extracted.
152: The supported file format (after extracting) is a.out (OMAGIC) or ELF.
153: Actually, it only assumes bootloaders or kernels.
154: If this option is specified at the same time as
155: <tt>prom-image</tt> in configuration file,
156: this option preceeds.
157: </q></p></dd>
1.1 root 158: <dt class=dt-indent><tt>-c <i>vmdir</i></tt></dt>
1.1.1.2 root 159: <dd>VM ディレクトリを指定します。省略するとカレントディレクトリとします。
160: <q>Specifies the VM directory. If omitted, the current directory is used.</q></p></dd>
1.1 root 161: <dt class=dt-indent><tt>-f</tt></dt>
162: <dd>高速モードで起動します。
1.1.1.2 root 163: GUI なら起動後にもメニューから変更できますが、その初期値を変えるだけです。
164: <q>Boot as the fast mode.
165: You can change this mode on GUI menu after boot,
166: and the option only changes its initial state.
167: </q></p></dd>
1.1 root 168: <dt class=dt-indent><tt>--fontsize <i>height</i></tt></dt>
169: <dd>GUI 版のみ。
170: 全サブウインドウの起動時のフォントサイズを指定します。
1.1.1.2 root 171: <tt><i>height</i></tt> には 12, 16
172: のいずれかを指定します。デフォルトは <tt>12</tt> です。
1.1.1.3 root 173: 起動後にメニューから変更できます。
1.1.1.2 root 174: <q>
175: GUI Only.
176: Specifies the initial fontsize on all sub windows.
177: <tt><i>height</i></tt> is one of 12 or 16.
1.1.1.3 root 178: The default value is <tt>12</tt>.
179: You can change this value on GUI menu after boot.
1.1.1.2 root 180: </q></p></dd>
1.1 root 181: <dt class=dt-indent><tt>-s <i>scale</i></tt></dt>
182: <dt class=dt-indent><tt>--scale <i>scale</i></tt></dt>
183: <dd>GUI 版のみ。
184: メインウィンドウの起動時のスケールを実数で指定します。
185: 起動後にもメニューからプリセットされた倍率には変更可能ですが、
186: 任意倍率は起動時のみ指定可能です
187: <span class=strike>(そのうちなんとかしたい)</span>。
1.1.1.2 root 188: デフォルトは 1.0 です。
189: <q>
190: GUI Only.
191: Specifies the initial main window scale in real number.
192: You can change this scale on GUI menu after boot,
193: but unlike this option, there are only a few preset choices
194: <span class=strike>(Should be improved in someday)</span>.
195: The default value is 1.0</q></p></dd>
1.1 root 196: <dt class=dt-indent><tt>--show-config</tt></dt>
1.1.1.2 root 197: <dd>設定ファイルと <tt>-V</tt> オプションを読み込んだ結果を表示します。
198: <q>Shows the result of reading configuration file and
199: parsing <tt>-V</tt> options.</q></p></dd>
1.1 root 200: <dt class=dt-indent><tt>-v</tt></dt>
1.1.1.2 root 201: <dd>バージョンを表示します。
202: <q>Shows the version.</q></p></dd>
1.1 root 203: <dt class=dt-indent><tt>-V <i>name</i>=<i>value</i></tt></dt>
1.1.1.3 root 204: <dd>設定ファイルで指定した <tt><i>name</i>=<i>configvalue</i></tt> の代わりに
1.1.1.2 root 205: このオプションの <tt><i>name</i>=<i>value</i></tt> を適用します。
1.1.1.3 root 206: <q>Use this <i>name</i>=<i>value</i>
207: instead of <i>name</i>=<i>configvalue</i> specified in configuration file.
1.1.1.2 root 208: </q></p></dd>
1.1 root 209: </dl>
210:
1.1.1.2 root 211: 以下開発用。<q>For developers:</q>
1.1 root 212: <dl>
1.1.1.3 root 213: <dt class=dt-indent><tt>-b <i>hexaddr</i>[,<i>skipcount</i>]</tt></dt>
1.1 root 214: <dd>デバッガのブレークポイントを 16進数で指定します。</dd>
215: <dt class=dt-indent><tt>-C</tt></dt>
216: <dd>ログをコンソールにも出力します。
217: 通常はログウィンドウにだけ出力されます。</dd>
218: <dt class=dt-indent><tt>-d</tt></dt>
219: <dd>起動時にデバッガプロンプトで停止します。</dd>
220: <dt class=dt-indent><tt>-D</tt></dt>
221: <dd>コンソールをデバッガとして使用します。
222: -d を指定しなくても起動時にプロンプトで停止します
223: <span class=strike>(そのうちなんとかしたい)</span>。</dd>
224: <dt class=dt-indent><tt>-L <i>name1</i>=<i>level1</i>[,<i>name2</i>=<i>level2</i>,...]</tt></dt>
225: <dd>ログレベルを指定します。
226: カンマで区切って複数指定することも出来ます。
227: <tt>-Lhelp</tt> で name の一覧を表示します。</dd>
228: <dt class=dt-indent><tt>-M <i>name</i>[,<i>name2</i>,...]</tt></dt>
229: <dd>起動時に表示するモニタウィンドウを指定します。
1.1.1.3 root 230: カンマで区切って複数指定することも出来ます。
231: <tt>-Mhelp</tt> で name の一覧を表示します。</dd>
1.1 root 232: </dl>
233: </div>
234:
235: <h4>設定 <q>Configuration</q></h4>
236: <div class="main">
237: VM の設定ファイルはその VM ディレクトリ内の nono.cfg です。
238: 書式は <tt>key = value</tt> 形式で1行1項目ずつです。
239: <tt>key</tt> と <tt>value</tt> の前後の空白は取り除かれます。
240: また空行と "<tt>#</tt>" で始まる行は無視します。
241: 知らないキーの行も無視します。
1.1.1.2 root 242: <q>VM configuration file is nono.cfg in the VM directory.
243: Its syntax is <tt>key = value</tt> format, one per line.
244: White spaces before and after <tt>key</tt> and <tt>value</tt> are ignored.
245: And, blank lines, lines beginning with "<tt>#</tt>", and
246: lines with unrecognized key are also ignored.
247: </q>
1.1 root 248: <p>
249: 設定項目は次の通りです。
1.1.1.2 root 250: <q>The configuration items are:</q>
1.1 root 251: <dl>
252: <dt class=dt-indent><tt>vmtype = <i>string</i></tt></dt>
1.1.1.4 root 253: <dd>VM 種別を以下のいずれかから指定します。
254: 省略不可です。
255: <q>Specifies the VM type from the following.
256: This field is mandatory.
257: </q>
258: <table cellspacing=0 cellpadding=0>
259: <tr><td> <td><tt>luna</tt> <td>… LUNA-I
260: <tr><td><td><tt>luna88k</tt> <td>… LUNA88K (experimental)
261: </table></p></dd>
1.1 root 262: <dt class=dt-indent><tt>debugger-port = <i>integer</i></tt></dt>
263: <dd>デバッガの TCP 待ち受けポート番号を指定します。
264: 0 なら待ち受けを行いません。
1.1.1.4 root 265: デフォルトは 0 です。
266: <q>Specifies the TCP port number that debugger listens.
267: If 0, it will not listen.
268: The default is 0.</q></p></dd>
1.1 root 269: <dt class=dt-indent><tt>ethernet-hostdriver = <i>string</i></tt></dt>
270: <dd>イーサネットデバイスのホスト側ドライバを指定します。
271: <tt>none</tt>、<tt>tap</tt>、<tt>bpf</tt> が指定できます。
272: <tt>none</tt> ならホスト側とは一切通信を行いません。
273: <tt>tap</tt> か <tt>bpf</tt> かはホスト OS によってビルド時に決定します。
274: NetBSD なら <tt>tap</tt> です。</p></dd>
275: <dt class=dt-indent><tt>ethernet-macaddr = <i>string</i></tt></dt>
276: <dd>イーサネットデバイスの仮想マシン側の MAC アドレスを指定します。
277: <tt><i>XX</i>:<i>XX</i>:<i>XX</i>:<i>XX</i>:<i>XX</i>:<i>XX</i></tt>
278: 形式で指定します。
279: <tt>auto</tt> なら自動的に決定します。
280: デフォルトは <tt>auto</tt> です。</p></dd>
281: <dt class=dt-indent><tt>luna-dipsw1 = <i>string</i></tt></dt>
282: <dd>本体前面 DIPSW#1-1..#1-8 の内容を指定します。
283: "<tt>0</tt>" を DOWN、"<tt>1</tt>" を UP として、
284: これを8つ並べた形式で、前から順に #1..#8 に対応します。
1.1.1.4 root 285: <q>Specifies status of the front panel DIPSW#1-1..#1-8 using 8 digit.
1.1.1.2 root 286: "<tt>0</tt>" means DOWN and "<tt>1</tt>" means UP.
287: The first character corresponds to #1 and
1.1.1.3 root 288: the eighth character corresponds to #8.</q>
289: <p>
290: LUNA-I でのデフォルトは <tt>11110111</tt> です。
291: 各スイッチの内容は以下のリンクを参照してください。
292: <q>On LUNA-I, the default value is <tt>11110111</tt>.
1.1.1.4 root 293: See the following link about DIPSW.</q><br>
1.1.1.3 root 294: → <a href="https://wiki.netbsd.org/ports/luna68k/luna68k_info/"
295: >NetBSD/luna68k: Information</a>
1.1 root 296: <br>
1.1.1.4 root 297: LUNA88K でのデフォルトは <tt>11111111</tt> です。
298: 各スイッチの内容は以下のリンクを参照してください。
299: <q>On LUNA88K, the default value is <tt>11111111</tt>.
300: See the following link about DIPSW.</q><br>
301: → <a href="http://man.openbsd.org/boot_luna88k.8"
302: >OpenBSD manual pages: boot_luna88k(8)</a></p></dd>
1.1 root 303: <dt class=dt-indent><tt>luna-dipsw2 = <i>string</i></tt></dt>
304: <dd>本体前面 DIPSW#2-1..#2-8 の内容を指定します。
305: 書式は <tt>luna-dipsw1</tt> と同じです。
306: デフォルトは <tt>11111111</tt> です。
1.1.1.2 root 307: <q>Specifies status of the front panel DIPSW#2-1..#2-8.
308: The same syntax as <tt>luna-dipsw1</tt> is used.
309: The default value is <tt>11111111</tt>.</q>
1.1.1.3 root 310: <p>
1.1.1.4 root 311: NetBSD/luna68k のブートローダは、
312: DIPSW#2 が "<tt>11111111</tt>" なら自動的にカーネルをロードして実行し、
313: どれかでも "<tt>0</tt>" にするとプロンプトで停止するようです。
1.1.1.2 root 314: <span class=strike>(本当は #8 だけで制御するつもりだったんじゃないかという気がします)</span>
1.1.1.4 root 315: <q>NetBSD/luna68k bootloader will automatically load and execute the kernel,
316: if the DIPSW#2 is "<tt>11111111</tt>".
1.1.1.2 root 317: Otherwise, the bootloader will enter interactive mode.
318: <span class=strike>(I doubt that they actually wanted to switch with only #8)
319: </span>
320: </q></p></dd>
1.1.1.3 root 321: <dt class=dt-indent><tt>monitor-rate = <i>integer</i></tt></dt>
322: <dd>テキスト系モニタウィンドウの更新頻度を Hz 単位で指定します。
323: 1 から 60 までの間で指定でき、デフォルトは 20Hz です。
324: 起動後にメニューからプリセットされた頻度には変更可能です。
325: <q>Specifies refresh rate of all text monitor windows in Hz.
326: It ranges from 1 to 60. The default is 20Hz.
327: You can change this value on GUI menu after boot,
328: but unlike this configuration value, there are only a few preset choices.
329: </q></p></dd>
1.1 root 330: <dt class=dt-indent><tt>mpu-clock = <i>value</i></tt></dt>
331: <dd>MPU のクロック数を MHz 単位で指定します。
1.1.1.5 root 332: デフォルトは LUNA-I なら 20MHz、LUNA88K なら 25MHz です。
333: <q>Specifies the MPU clock in MHz.
334: The default value is 20MHz on LUNA-I, or 25MHz on LUNA88K.</q></p></dd>
1.1.1.2 root 335: <dt class=dt-indent><tt>prom-image = <i>path</i></tt></dt>
1.1.1.4 root 336: <dd>LUNA-I/LUNA88K の外部 ROM イメージファイルのパスを指定します。
1.1.1.2 root 337: <i>path</i> がファイル名のみなら VM ディレクトリとその親ディレクトリからこのファイル名を検索します。
338: <i>path</i> が相対パスなら VM ディレクトリからの相対パスになります (現在のディレクトリからではありません)。
339: 空にすると内蔵 ROM を使用します。
340: デフォルトは空です。
1.1.1.4 root 341: <q>Specifies the LUNA-I/LUNA88K's external ROM image file path.
1.1.1.2 root 342: If the <i>path</i> does not have any path delimiters,
343: the VM directory and then its parent directory will be searched.
344: If the <i>path</i> is a relative path,
345: it will be path from the VM directory, not from the current
346: directory.
347: If the <i>path</i> is empty, internal emulated ROM will be used.
348: The default value is empty.</q>
1.1 root 349: <p>
1.1.1.2 root 350: 実機を持っていない場合はこの値を空に (= デフォルトのままに) しておくと、
1.1.1.4 root 351: nono 内蔵のなんちゃって下位互換 ROM で起動します(現状 LUNA-I のみ)。
1.1.1.2 root 352: <q>If you does not have the real LUNA machines,
353: you can boot with nono's internal downward compatible emulated ROM
1.1.1.4 root 354: if you set this field empty (or leave it as the default).
355: For now, it's only for LUNA-I.
356: </q>
1.1 root 357: <p>
1.1.1.4 root 358: LUNA-I 実機を持っている場合は
359: ROM ファイルを指定することで実機 ROM で起動できます。
1.1.1.2 root 360: ROM ファイルは実機の 0x41000000-0x4101ffff (128KB) を保存したものです。
1.1.1.3 root 361: 今のところ ROM は V4.22 (Thu Jul 27 11:45:42 1989) のみサポートしています。
362: それ以外については何も分かりません。
1.1.1.4 root 363: <q>If you have the real LUNA-I machine,
1.1.1.2 root 364: you can boot with the real ROM spcifying the ROM file path.
1.1.1.4 root 365: The ROM file is extracted from 0x41000000-0x4101ffff (128KB) of
366: the real LUNA-I machine.
1.1.1.3 root 367: For now, only V4.22 (Thu Jul 27 11:45:42 1989) is supported.
368: I have no idea about other ROMs.
1.1.1.4 root 369: </q>
370: <p>
371: LUNA88K 実機の場合は 0x41000000-0x4103ffff (256KB) を保存したものです。
372: ただし現状サポートしていません。
373: <q>
374: For LUNA88K,
375: the ROM file is extracted from 0x41000000-0x4103ffff (256KB).
376: However, it's not supported yet.
1.1.1.3 root 377: </q></p></dd>
378: <dt class=dt-indent><tt>ram-size = <i>integer</i></tt></dt>
1.1.1.2 root 379: <dd>搭載する RAM サイズを MB 単位で指定します。
1.1.1.5 root 380: デフォルトは LUNA-I は 16MB、LUNA88K は 64MB です。
381: まだたぶん変更できません。
382: <q>Specifies the RAM size in MB.
383: The default is 16MB on LUNA-I or 64MB on LUNA88K.
384: Not supported yet.</q></p></dd>
1.1 root 385: <dt class=dt-indent><tt>spc0-id<i>N</i>-image = <i>devtype</i>,<i>path</i></tt></dt>
386: <dd>SCSI デバイスを指定します。<i>N</i> には 0 から 7 が入ります。
387: ID 7 は本体が使用しますので指定しないでください。
388: 値はデバイス種別 <i>devtype</i> とイメージパス <i>path</i>
389: を "<tt>,</tt>"(カンマ) で区切って並べた形式で、
390: 今の所デバイス種別 <i>devtype</i> には "<tt>hd</tt>"(ハードディスク) のみ指定可能です。
391: ディスクイメージパスが相対パスなら VM ディレクトリからの相対パスになります。
1.1.1.2 root 392: <q>
393: Specifies SCSI device. <i>N</i> is 0 to 7.
394: But don't specify ID 7 because the host uses it.
395: The value is in a form of device type <i>devtype</i> and
396: the image path <i>path</i> separated by "<tt>,</tt>"(comma).
397: For now, only "<tt>hd</tt>" (hard disk) can be specified for <i>devtype</i>.
398: If the <i>path</i> is relative path, it is from the VM directory.
399: </q>
400:
1.1 root 401: <p>
402: 例えば、nono.cfg と同じディレクトリに置いたディスクイメージ luna.img
403: を使う場合、
1.1.1.5 root 404: LUNA-I では通常 ID 6 をプライマリ HDD に割り当てるのでこんな感じになります。
1.1.1.2 root 405: <q>For example, if you use disk image luna.img placed in the same
406: directory as nono.cfg,
1.1.1.5 root 407: since LUNA-I usually assigns ID 6 to the primary HDD,
1.1.1.2 root 408: write as following:</q>
1.1 root 409: <blockquote><pre>
410: spc0-id6-image = hd,luna.img
411: </pre></blockquote></p></dd>
1.1.1.4 root 412: <dt class=dt-indent><tt>spc0-id<i>N</i>-seektime = <i>integer</i></tt></dt>
413: <dd>指定の SCSI HDD の平均シークタイムを msec 単位で指定します。
414: 現在のデフォルトは <tt>0</tt> です (S・S・D!! S・S・D!!)。
415: 16 程度を指定すると幾分往時に思いを馳せることが出来るかもしれませんが、
416: 今の所あまり安定していません。
417: <q>Specifies the average seek time of specified SCSI HDD in msec.
418: Currently, the default value is <tt>0</tt>
419: (This may be something like SSD :-).
420: If you specify about 16 or so, you can feel nostalgic,
421: but this feature is still unstable.
422: </q></p></dd>
1.1 root 423: <dt class=dt-indent><tt>spc0-id<i>N</i>-writeprotect = <i>integer</i></tt></dt>
424: <dd>指定の SCSI デバイスへの書き込みを無視するかどうか指定します。
425: <tt>0</tt> なら通常動作(書き込みを行う)です。
426: <tt>1</tt> なら書き込みコマンドは成功したように振る舞いますが実際には
427: ディスクイメージに一切書き戻しません。
428: fsck を気にせずカーネルのデバッグとかを行いたい場合にはどうぞ。
429: 何が起きるか意味が分からない人は指定しないでください。
1.1.1.2 root 430: デフォルトは <tt>0</tt> です。
431: <q>Specifies whether nono ignores writing to SCSI devices.
432: <tt>0</tt> means normal operation (writes to the devices).
433: If <tt>1</tt> is specified,
434: nono will not actually write back to the disk image
435: even though the write command is succeeded.
436: nono's SCSI devices acts as
437: write command is successfully done but it never writes back
438: to the actual disk image.
439: This is useful for kernel debugging because it does not require fsck
440: after the kernel hangs.
441: But don't use this flag if you don't understand this paragraph.
442: The default value is <tt>0</tt>.
443: </q></p></dd>
1.1 root 444: </dl>
445: </div>
446:
447:
448: <h4>実行してみる <q>Try it</q></h4>
449: <div class="main">
1.1.1.2 root 450: つついさんが NetBSD/luna68k 9.0 の liveimage を用意してくださっています
451: (いつもありがとうございます)。
452: <q>Tsutsui-san has provided NetBSD/luna68k 9.0 liveimage for this
453: (Thanks as always).</q>
454: <br>
455: <ol>
456: <li>どこかに nono 用のディレクトリを用意し(例えば ~/nono/)、
1.1 root 457: その中に VM ディレクトリを用意します (例えば ~/nono/luna/)。
1.1.1.3 root 458: <q>Create a directory somewhere for nono (for example ~/nono/),
1.1.1.2 root 459: and create subdirectory for individual VMs in it (for example ~/nono/luna).</q>
1.1 root 460:
1.1.1.3 root 461: <li>以下のリンクからイメージファイルをダウンロードして展開し、
1.1.1.2 root 462: VM ディレクトリ ~/nono/luna/ に置きます。
1.1.1.3 root 463: <q>Download imagefile from the following link,
1.1.1.2 root 464: extract it and place it in the VM directory, ~/nono/luna.</q>
1.1.1.3 root 465: <blockquote>
466: <a href="http://teokurebsd.org/netbsd/liveimage/20200518-luna68k/"
467: >http://teokurebsd.org/netbsd/liveimage/20200518-luna68k/</a>
468: </blockquote>
1.1.1.2 root 469:
470: <li>同じく VM ディレクトリに設定ファイル nono.cfg を以下の内容で用意します。
471: <q>Create a configuration file nono.cfg in the same VM directory, ~/nono/luna,
472: with following contents:</q>
473: <blockquote class="file"><pre>
474: vmtype = luna
475: spc0-id6-image = hd,liveimage-luna68k-raw-20200518.img
476: </pre></blockquote>
477: <li><tt>nono -c ~/nono/luna</tt> で起動します
478: (VM ディレクトリに自動的に NVRAM.DAT が作られます)。
479: <q>Run as <tt>nono -c ~/nono/luna</tt>.
1.1.1.4 root 480: (NVRAM.DAT will be created automatically in the VM directory)</q>
1.1.1.2 root 481: <li>Emulated ROM Monitor が起動するので、
482: 初回は以下のように入力すると NetBSD が起動します。
483: <q>The emulated ROM Monitor will be executed.
484: Then, only for the first time,
485: entering the following can boot NetBSD.</q>
486: <blockquote class="file"><pre>
487: k
488: [Enter]
489: [Enter]
490: d
491: boot
492: g
493: x
494: </pre></blockquote>
495: この内容は NVRAM.DAT に記録されているので次回以降は直接 NetBSD が起動します。
496: <q>The information you have just entered is recorded in NVRAM,
497: so next time it boots NetBSD automatically.</q>
498: </ol>
499: <p>
500: <a href="https://twitter.com/tsutsuii/status/1262429647364427783"
501: >元ツイートはこちら<q>Original tweet</q></a>。
1.1 root 502: </div>
503:
504:
505: <h4>ネットワーク設定 <q>Setup network</q></h4>
506: <div class=main>
1.1.1.2 root 507: 設定ファイル nono.cfg に以下の行を追加します。
508: <q>Add the following line to configuration file, nono.cfg.</q>
1.1 root 509: <blockquote class="file"><pre>
510: ethernet-hostdriver = tap
511: </pre></blockquote>
1.1.1.2 root 512: 次に VM ディレクトリかその親ディレクトリに nono-ifup、nono-ifdown
513: というスクリプトを用意します。
1.1 root 514: nono は tap(4) をオープンし、
515: そのデバイス名を引数にこれらのスクリプトを呼びます。
1.1.1.2 root 516: <q>Then, prepare two scripts named nono-ifup and nono-ifdown
517: in the VM directory or its parent directory.
518: nono will open tap(4) and
519: invoke these scripts with the name of the device as an argument.</q>
1.1 root 520: <p>
1.1.1.5 root 521: 例えば、NetBSD ホストで、ホストの wm0 セグメントに nono のゲスト OS を接続する場合、
522: <q>For example, if you want to connect guest OS to host's wm0 segment
523: on NetBSD,</q>
524: <ol>
525: <li>デフォルトでは /dev/tap は一般ユーザからアクセスできないので、
526: chmod で適当にパーミッションを与えます。
527: 番号の付いていないほうの /dev/tap だけでいいです。
528: <q>By default, /dev/tap is only accessible to privileged user.
529: You need to chmod /dev/tap (without unit number) appropriately.</q>
530: sysinst 等で OS をアップグレードするとパーミッションが 600
531: に戻るのがハマりポイントです。
532:
533: <li>bridge(4) インタフェースを作成し、
534: ホストの外側のインタフェースをブリッジに追加しておきます。
535: <q>Create a bridge(4) interface, and
536: add your physical interface to the bridge.</q>
1.1 root 537: <blockquote class="cons"><pre>
1.1.1.5 root 538: # ifconfig bridge0 create
1.1 root 539: # brconfig bridge0 add wm0
540: </pre></blockquote>
1.1.1.5 root 541: 常用するなら設定ファイルに書いておきましょう。
542: <q>If you want to use this all the time,
543: you can put configuration file into /etc.</q>
544: <blockquote>
545: /etc/ifconfig.bridge0
546: <pre class=file>
547: create
548: up
549: !/sbin/brconfig $int add wm0
550: </pre>
551: <pre class=cons>
552: # /etc/rc.d/network restart
553: </pre>
554: </blockquote>
555:
556: <li>
557: 一般ユーザに戻って、
558: VM ディレクトリかその親ディレクトリに
559: 次のような 2つのスクリプトを用意します。
560: sudo の設定は別途行ってください。
561: <q>Return to non-privileged user, and
562: create following two scripts in the VM directory or its parent directory.
563: In addition, you need to set up sudo separately.</q>
1.1 root 564: <blockquote>
565: nono-ifup
566: <pre class=file>
567: #!/bin/sh
1.1.1.5 root 568: sudo /sbin/ifconfig $1 up
569: sudo /sbin/brconfig bridge0 add $1
1.1 root 570: </pre></blockquote>
571:
572: <blockquote>
1.1.1.5 root 573: nono-ifdown
1.1 root 574: <pre class=file>
575: #!/bin/sh
1.1.1.5 root 576: sudo /sbin/brconfig bridge0 delete $1
577: sudo /sbin/ifconfig $1 down
578: </pre></blockquote>
579:
580: <blockquote class="cons"><pre>
581: % chmod +x nono-ifup nono-ifdown
1.1 root 582: </pre></blockquote>
583:
1.1.1.5 root 584: <li>nono を起動し、
585: メニューの「モニタ > ホスト > ホストネットワーク」を開いて
586: NetDriver が None 以外 (この場合 BSD tap) になっていれば動いてるはずです。
587: <q>Run nono,
588: and open "Monitor > Host > Host Network" window from menu.
589: It's OK if you can see "NetDriver: BSD tap" (in this case).</q>
590:
591: </ol>
592:
1.1 root 593: </div>
594:
595:
1.1.1.2 root 596: <h4>変更履歴 <q>Changes</q></h4>
597: <div class="main">
598: See <a href="changes.html">changes.html</a>.
599: </div>
600:
601:
602: <h4>ライセンス <q>License</q></h4>
603: <div class="main">
604: See <a href="nono-license.txt">nono-license.txt</a>.
605: </div>
606:
607:
1.1.1.4 root 608: <h4>連絡先 <q>Contact us</q></h4>
609: <div class="main">
610: バグ報告などは以下にお願いします。日本語でおk。
611: <q>If you find any problems, please let me know.
612: You may write in English.</q><br>
613: <a href="https://github.com/isaki68k/nono-issue/issues"
614: >https://github.com/isaki68k/nono-issue/issues</a>
615: </div>
616:
617:
1.1.1.2 root 618: <h4>パッチの提供について <q>About contributes</q></h4>
619: <div class="main">
620: パッチを提供してくださる場合は以下に同意したものとします。
621: <q>If you provide a patch to nono, you must agree to the following conditions:
622: </q>
623: <ul>
624: <li>成果物が nono のライセンスに従って運用あるいは配布されること。
625: <q>All your work are operated or distributed under the nono license.</q>
626: <li>ライセンスが将来変わる可能性があること。
627: <q>The license may be changed in the future.</q>
628: <li>著作部分に関して著作者人格権を行使しないこと。
629: <q>Do not exercise your author's rights.</q>
630: </ul>
631: <ul>
632: </div>
633:
634:
635: <h4>Acknowledgements</h4>
636: <div class="main">
637: nono は以下の広告条項を含むソースコードを利用しています。
638: <q>nono uses source code with the following advertising clause.</q>
639: <blockquote>
640: This product includes software developed by Gordon Ross<br>
641: This product includes software developed by the University of California, Lawrence Berkeley Laboratory.<br>
642: </blockquote>
643: </div>
644:
1.1 root 645:
646: <hr>
1.1.1.2 root 647: nono project
1.1 root 648: </body>
649: </html>
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.