Annotation of nono/doc/index.html, revision 1.1.1.2

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

unix.superglobalmegacorp.com

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