Annotation of nono/doc/index.php, revision 1.1.1.3

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

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.