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