2.6.5 レジスタ・セットを指定するためのヘルプ |
 |
コンパイラを起動する際，コマンド行で /FLAG=HINTS を指定すると，ルーチンのエントリ・ポイントに対してレジスタ・セットを構成するのに役立つメッセージが表示されます。コンパイラが出力するヒントの中には，以下の内容が出力されます。
- ルーチンの入力として使用されている可能性があるレジスタ。ただし，意図していないレジスタが表示されることがあります。レジスタに書き込む前に読み込むと，ここで出力されます。
- 出力値として使用されている可能性があるレジスタ。レジスタに書き込んだ後に読み込みを行っていないと，そのレジスタは出力値として使用されている可能性があるレジスタの一覧に追加されます。これも，意図していないレジスタが表示されることがあります。
- エントリ・ポイントの preserve 引数に指定されておらず，コンパイラが保存と復元を行うレジスタ。
.CALL_ENTRY，.JSB_ENTRY，および .JSB32_ENTRY のレジスタ引数に，ルーチンのテキスト・ヘッダに記述されているルーチンのインタフェースを反映させることをお勧めします。レジスタ引数
input，output，
scratch，および preserve は，できるだけすべてのルーチンで宣言してください。引数を指定するのは，宣言するレジスタがある場合だけでかまいません (たとえば，input=<> は必要ありません)。
あるルーチンの本体から，同じモジュールおよび psect にある別のルーチンの本体に分岐することができます。しかし，両方のルーチンでオーバヘッドが増えることになるため，コンパイラによって情報レベルのメッセージが出力されます。
 | 注意
コンパイラは $EXIT の呼び出しをルーチンの終了として認識しません。ルーチンを終了させるには， $EXIT の後に RET または RSB のうち適切なものを追加してください。
|
CALL ルーチンが，RSB を実行するコード・パスに分岐する場合，エラー・メッセージが出力されます。このような CALL ルーチンは，修正しないと，実行時にエラーになります。
JSB ルーチンが，RET 命令を実行するコード・パスに分岐し， JSB ルーチンがレジスタを保護する場合，情報メッセージが出力されます。この構造は実行時に動作しますが， JSB ルーチンによって保存されたレジスタは復元されません。
コード・パスを共用する複数のルーチンのレジスタ宣言が異なっていると，レジスタの復元は条件付きで行われます。すなわち，ルーチンの入口で保存されるレジスタはどちらのルーチンでも同じですが，レジスタが復元されるかどうかは，どちらのエントリ・ポイントが実行されたかによって変わります。
以下に例を示します。
rout1: .jsb_entry output=r3
movl r1, r3 ! R3 is output, not preserved
movl r2, r4 ! R4 should be preserved
blss lab1
rsb
rout2: .jsb_entry ! R3 is not output, and
movl #4, r3 ! should be auto-preserved
movl r0, r4 ! R4 should be preserved
lab1: clrl r0
rsb
|
どちらのルーチンでも，ルーチンの入口で R3 は保存レジスタに含まれます。しかしルーチンの出口では， R3 を復元する前にマスク (同様に入口で保存されます) がテストされます。 R4 はどちらのエントリ・ポイントでも復元される必要があるため， R4 の復元の前にはマスクはテストされません。
コードを共用する 2 つのルーチンで書き込みが行われるレジスタを，一方では scratch として宣言し他方では宣言しないと，保存と復元を行うよりもコストが高くなります。この場合，両方で scratch として宣言するか，一方のルーチンで保護が必要な場合は，両方で preserve として宣言します。
付録 B で説明するとおり， .EXCEPTION_ENTRY 指示文は，例外サービス・ルーチンのエントリ・ポイントを示します。 .EXCEPTION_ENTRY 指示文は，以下のような割り込みを扱うルーチンのエントリ・ポイントを宣言するために使用します。
- インターバル・クロック
- プロセッサ間割り込み
- システムとプロセッサの訂正可能なエラー
- 電源障害
- システムとプロセッサのマシン・アボート
- ソフトウェア割り込み
ルーチンの入口で， R3 にはプロシージャ記述子のアドレスが格納されている必要があります。ルーチンは REI 命令で終了する必要があります。
例外エントリ・ポイントで，割り込みディスパッチャは，レジスタ R2 〜 R7，PC，PSL をスタックにプッシュします。これらのレジスタの内容にアクセスするには， .EXCEPTION_ENTRY 指示文で stack_base 引数を指定します。コンパイラは，
stack_base に指定したレジスタに SP の値を設定するコードをルーチンの入口に生成し，例外サービス・ルーチンがこのレジスタを使用して，スタック上のレジスタの値を使用できるようにします。
コンパイラは，ルーチンで使用されているその他すべてのレジスタを自動的に保存して復元します。さらに，サービス・ルーチンが CALL 命令または JSB 命令を実行する場合， R0 と R1 を含むすべてのスクラッチ・レジスタが自動的に保存および復元されます。
| 注意
フレームの 0(FP)にアドレスを格納することで設定されるエラー処理ルーチンは，.EXCEPTION_ENTRY ルーチンではありません。このようなエラー・ハンドラは，.CALL_ENTRY ルーチンとして宣言し， RET 命令で終了する必要があります。
|
