Annotation of nono/doc/human.php, revision 1.1.1.1

1.1       root        1: <!--
                      2:  nono
                      3:  Copyright (C) 2024 nono project
                      4:  Licensed under nono-license.txt
                      5: -->
                      6: <?php require_once "common.php"; ?>
                      7: <html>
                      8: <head>
                      9: <?php
                     10:        get_version();
                     11:        print_head_common();
                     12: ?>
                     13: <title>nono: Human68k mode</title>
                     14: </head>
                     15: <body>
                     16: <h3>nono の Human68k モード</h3>
                     17: <div style="text-align: right"><?php print "nono {$nono_ver} ({$nono_date})";
                     18: ?></div>
                     19: <?php linkto("index", "[Back]"); ?>
                     20: <hr>
                     21: nono には通常の特定ハードウェア (X68030 など) の完全仮想化機能の他に、
                     22: コマンドラインから Human68k の実行ファイルを直接実行する機能があります。
                     23: ここでは雑に Human68k モードと呼んだりしています。
                     24: 
                     25: <h4>使い方</h4>
                     26: 起動方法は以下の通りです。
                     27: <blockquote>
                     28: <tt>nono-cli -H [<i>other options</i>...] -X <i>executable</i> [<i>argument</i>...]</tt><br>
                     29: </blockquote>
                     30: <tt>-H</tt> オプションで Human68k モードであることを指定します。
                     31: nono の他のオプションもだいたいそのまま使えますが
                     32: <tt>-c</tt> と <tt>-X</tt> オプションは通常モードとは挙動が変わります。
                     33: 
                     34: <dl>
                     35: <dt><tt>-c <i>vmpath</i></tt>
                     36: <dd><tt>-c</tt> オプションは VM ディレクトリか設定ファイルを指定します。
                     37: <tt>-c</tt> オプションが省略された場合、通常モードでは
                     38: <i>vmpath</i> をカレントディレクトリとしてそこから設定ファイルを読みましたが、
                     39: Human68k モードでは匿名モードとなります。
                     40: 匿名モードは VM ディレクトリがなく、そのためホストの SRAM.DAT
                     41: を読み書きしません。
                     42: SRAM は初期状態のものをオンメモリで用意し、
                     43: アプリケーション終了時にそのまま破棄します。
                     44: これによりカレントディレクトリに SRAM.DAT を用意する手間と
                     45: カレントディレクトリに SRAM.DAT が書き出される問題がなくなります。
                     46: 実行するアプリケーションから
                     47: SRAM.DAT にアクセスしたい場合は <tt>-c</tt> オプションで
                     48: VM ディレクトリパスを明示します。
                     49: <p>
                     50: <dt><tt>-X <i>executable</i> [<i>arguments</i>...]</tt>
                     51: <dd>通常モードでは <tt>-X</tt> オプションは
                     52: ホストファイルシステムにある実行ファイルのパスを指定していました。
                     53: Human68k でもここまでは同じですが、
                     54: 実行ファイルに続いてコマンドライン引数を指定することが出来ます。
                     55: またこれにより <tt>-X</tt> オプションよりも後ろに
                     56: nono の他のコマンドラインオプションを書くことは出来ませんので
                     57: 順序に注意してください。
                     58: 
                     59: </dl>
                     60: <p>
                     61: CLI 版(<tt>nono-cli</tt>) だけでなく
                     62: GUI 版(<tt>nono</tt>) でも Human68k モードは動作しますが、
                     63: メイン画面ウィンドウには何も映りません。
                     64: デバッグ用のモニタウィンドウが使えるだけです。
                     65: 
                     66: <h4>サポート状況</h4>
                     67: 拡張子 .X と .R の形式の実行ファイルをサポートしています
                     68: (.Z 形式も一応サポートしていますが現物を見たことないので詳細不明)。
                     69: また、Human68k の実行ファイルではありませんが
                     70: ELF の m68k オブジェクトファイル (.o) も外部ラベルがないなどの条件を満たせば、
                     71: テキストセクションを .R 形式のように先頭から実行可能です
                     72: (<tt>DOS _EXIT</tt> で終了します)。
                     73: <p>
                     74: Human68k 実行ファイルのうち、
                     75: ハードウェアの I/O を直接叩いているようなものは動作しません。
                     76: 現状、標準入出力など簡単な DOS コール、IOCS コールのみサポートしています。
                     77: 
                     78: 
                     79: <h4>使用例</h4>
                     80: 以下を実行すると、nono の 68030 CPU の整数命令が
                     81: 正しく実装されているかを確認することが出来ます。
                     82: <blockquote><tt>nono-cli -HX XEiJ/misc/instructiontest.x all</tt>
                     83: </blockquote>
                     84: 
                     85: <hr>
                     86: nono project
                     87: </body>
                     88: </html>

unix.superglobalmegacorp.com

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