到達目標:例外を受けたことと代行できることを分ける
前章までにEL1ゲストへ入り、EL2の同期例外入口へ戻る経路を準備しました。しかしData Abortが来たという事実だけで、UARTへ文字を出してよいわけではありません。この章では、例外クラス、有効な命令情報、アクセス幅、読書き方向、対象IPAを確認し、対応する一つの操作だけを代行します。受理に必要な条件をすべて満たした後で、初めてゲストの復帰先を進めます。
配布版で扱うのは、仮想UARTのデータレジスタに対する通常の1バイト書込みです。PL011全体のレジスタ互換性、割り込み、FIFOの詳細、DMA、virtioはこの実装の範囲ではありません。第2弾の概念モデルで広く観察した機能と、今回QEMUで実際に動かす狭い実装を区別してください。狭くても、正常系だけでなく、幅の境界と未対応アクセスの拒否まで実測することで、代行処理の契約を確かめられます。
RAMは対応させ、UARTのIPAを空ける
配布版のstage 2は4KiB粒度の表形式を使い、開始レベル1、39ビットのIPA範囲として設定します。L1表のインデックス1には、0x40000000からのRAMを対応させる1GiBのブロック記述子を置きます。一方、UARTのIPAである0x09000000を含む場所には有効な記述子を置きません。このため、ゲストのコードとスタックは動きますが、そのUARTアドレスへのアクセスは変換例外になります。
設定値VTCR_EL2=0x80023559とHCR_EL2=0x80000001は、収録した構成の値です。VTTBR_EL2は整列したstage 2の表を指します。表の内容を用意してから、必要な同期化と変換状態の扱いを経て利用します。ここでの1GiB対応は読みやすさを優先した教材用の粗い範囲です。ホストとゲストは同じELFにあり、この対応だけで信頼できないゲストを完全に隔離できるとは主張しません。
ESRを外側から順番に検査する
実測した通常書込みのESR_EL2は0x93090045です。上位のECは0x24で、下位例外レベルからのData Abortを表します。ILはこの経路の32ビット命令長、ISVは命令情報の有効性に関係します。SAS=0からバイト幅、SRT=9から保存済みW9、WnR=1から書込みを読み取れます。下位のDFSC=5は、この実行で発生したレベル1の変換例外に対応します。各フィールドを一度に文字列へ置換せず、順に判定します。
配布版のdecode_uart_writeは、無効な命令情報、使えないFAR、stage 1のテーブルウォーク中の例外、読込み、未対応幅、変換例外以外を拒否します。ISVを見ずにSASやSRTを信用すると、別の原因の例外を誤ってUART書込みとして処理し得ます。登録番号31は通常の配列要素ではなくゼロレジスタとして扱います。保存フレームは31本なので、番号31をそのまま添字にしてはいけません。
| フィールド | 通常実行の値 | デコーダでの意味 |
|---|---|---|
| EC | 0x24 | 下位レベルからのData Abort |
| IL / ISV | 1 / 1 | 32ビット命令長と有効な命令情報 |
| SAS | 0 | 1バイト幅 |
| SRT | 9 | 保存済みW9から値を取得 |
| WnR | 1 | 書込み |
| DFSC | 5 | 収録ではレベル1の変換例外 |
FARとHPFARから対象IPAを確かめる
FAR_EL2とHPFAR_EL2は同じアドレスをそのまま二重に持つものではありません。この配布構成で扱う有効な変換例外では、HPFARのFIPA部分からページより上のIPAを取り出し、FARの下位12ビットを合わせます。通常記録ではFAR=0x09000000、HPFAR=0x00090000で、再構成したIPAは0x09000000です。まず例外条件を検査し、その条件で値が使えることを確かめてから再構成します。
ページ内のどの位置でもUARTと見なすのではなく、データレジスタのIPAと完全一致するかを検査します。0x09000001は同じページにあっても、この実装の対応対象ではありません。また、読込みと書込み、1バイトと4バイトでは代行内容が異なります。アドレスだけ合えば何でも出力する処理にしないことが、未対応のゲスト動作を誤って成功扱いしないための重要な境界になります。
フィールドと境界値を実行して確かめる
次のホスト用Rustコードは、収録値の読み取りと、IPAのページ内位置を変えたときの違いを確認します。命令情報の完全な受理判定は配布版のsrc/lib.rsにあるdecode_uart_writeと、その単体試験で調べます。この短い例では、値0x141をバイトとして取り出すと0x41になることと、ゼロレジスタを配列の外へ読みに行かないことを明示します。バイト幅の意味を、表示する文字と整数値の両方で考えてください。
正常例はAの0x41、境界例は最大バイト0xffとゼロレジスタ、失敗の手掛かりはアドレスの1バイト差とSASの変更です。このプログラムはUARTへアクセスせず、例外を発生させません。数値の分解が正しいという確認と、QEMUがその命令でその例外を発生させたという確認は異なります。配布版の単体試験と実行記録を併せて読むことで、計算と観測を結び付けます。
// Host-side interpretation of measured fields; not a machine handler.
fn ipa(far: u64, hpfar: u64) -> u64 {
((hpfar & 0x0000_ffff_ffff_fff0) << 8) | (far & 0xfff)
}
fn stored_byte(register: usize, saved: &[u64;31]) -> u8 {
if register == 31 { 0 } else { saved[register] as u8 }
}
fn main() {
let esr = 0x9309_0045u64;
assert_eq!((esr >> 26) & 63, 0x24);
assert_eq!((esr >> 24) & 1, 1);
assert_eq!((esr >> 22) & 3, 0);
assert_eq!((esr >> 16) & 31, 9);
assert_eq!((esr >> 6) & 1, 1);
assert_eq!(esr & 63, 5);
assert_eq!(ipa(0x0900_0000, 0x0009_0000), 0x0900_0000);
assert_ne!(ipa(0x0900_0001, 0x0009_0000), 0x0900_0000);
let mut saved = [0u64;31]; saved[9] = 0x141;
assert_eq!(stored_byte(9, &saved), b'A');
saved[9] = 255;
assert_eq!(stored_byte(9, &saved), 255);
assert_eq!(stored_byte(31, &saved), 0);
assert_eq!(((esr | (2 << 22)) >> 22) & 3, 2);
}実測した代行と再開を読む
配布版の通常実行では、コンパイラが生成したゲストのSTRBがW9のAをX8の指すUARTへ書こうとし、変換例外になります。EL2は保存フレームの9番からバイトを取り出し、ホスト側のUARTアクセスでAを出力します。ゲストのストアをそのまま再実行しているのではなく、対応する副作用をEL2が一度実行しています。この違いを、TRAP、EMULATE、RESUMEの順に沿って説明してください。
代行に成功したときだけ、ハンドラはELR_EL2を4進めます。続くERETでゲストへ戻り、その後のHVCからGUEST_RESUMEDが記録されます。ゲストのビルドが変われば、ストアに使うレジスタ番号や命令の位置も変わり得ます。W9とX8は収録版の観測であり、デコーダが常にW9だけを読む設計ではありません。ソースのSRT検査が、コンパイラの選んだ番号を保存フレームに結び付けています。
正常・最大バイト・未対応幅を比較する
正常系はバイト値0x41を代行し、ゲスト再開と終了まで到達します。境界系はバイト値0xffを使い、同じ幅のまま整数値の上限を確かめます。0xffはUTF-8の単独文字として読めるとは限らないため、文字の見え方だけでなくBYTEの16進値を確認します。UARTの生ログを文字列へ変換するときも、元のバイト列を失わない形の記録と組にすることで、表示上の置換とゲストの値を区別できます。
失敗系は4バイト書込みで、実測ESRは0x93890045となりSAS=2です。配布版は幅を拒否し、ELRを進めず、GUEST_RESUMEDを出さずに失敗として終了します。単体試験ではこれに加えて、読込み、不正アドレス、無効な命令情報、ゼロレジスタなども検査します。未対応の値をAへ丸めたり、何もしないでPCだけ進めたりすると、ゲストとデバイスの状態が一致しなくなります。
演習:受理条件を一つずつ破る
配布プロジェクトのdecode_uart_writeについて、条件、拒否理由、対応する試験を表にしてください。まず既存の正常・境界・失敗を実行し、その後に一つの条件だけを変更します。たとえばアドレスを1増やす、読込みへ変える、ISVを落とすという変更は、それぞれ別の契約を調べます。複数の条件を同時に壊すと、最初の拒否だけが見えて後続条件の試験にならないため、入力を分離することが重要です。
発展課題は、読込みや別の幅を追加する場合の仕様を先に書くことです。返す値、ゼロ拡張や符号拡張、レジスタ31の扱い、副作用の回数、拒否時のPCを決めてから実装します。Webでの問題合格とローカル実装の完了申告は別です。ローカル課題では、完成版と自分の実装の試験結果を比較し、少なくとも正常・境界・失敗の三つの証拠を残してください。