到達目標:完了を知らせ、ゲストへ所有権を返す
デバイスがデータを作った後にも、ゲストが結果を読んでバッファを再利用するまでの処理が残ります。この章ではnotifyの末尾からinject、handle_guest_irq、ゲストのused回収へ進みます。データ転送、完了公開、割り込みの受領、デバイス通知の解除、GICの処理終了、バッファ回収を順に追い、一つの「完了」にまとめられない責任を分けます。
第4弾で作ったIRQ 40の経路を、今回はブロックI/Oの結果へ接続します。番号を印字するだけでなく、QEMUのGICv3を通ってゲストのIRQ入口へ入り、ゲストが結果を読みます。ただし対象は一つの信頼するゲストと、一件ずつ処理する要求です。複数CPU、同時に多数の未処理要求、割り込みの集約や抑制は、この教材の検証範囲に含めません。
公開を先にする:通知が来たら結果を読める状態へ
notifyはデータとstatusを書いた後、usedのスロットへ先頭記述子の番号と長さを置きます。メモリ順序を整えてからproducedを増やし、used.idxへ公開します。その後にデバイスのinterruptを1にしてIRQを注入します。通知だけ先に見えて、used.idxや結果がまだ古いという状態を避けるための順序です。
ここでのメモリバリアとvolatileなアクセスは役割が異なります。volatileは指定したメモリアクセスを実際に行うために使い、複数の共有メモリアクセスを相手へ見せる順序は別に扱います。この単一vCPUの教材でコードが動いたことを、任意のCPUやキャッシュ構成でもバリアが不要だという証拠にしないでください。公開するidxを境界として、その前に完成させる内容を列挙します。
IRQの処理:デバイスのACKとGICのEOIを区別する
injectはICH_LR0_EL2へPendingのIRQ 40を用意します。ゲストのhandle_guest_irqはICC_IAR1_EL1で受領した番号を読み、MMIOのInterruptStatusを調べます。bit 0ならusedの完了通知、bit 1なら構成変更です。構成変更ではdevice statusも読み、リセットの必要を確認してからInterruptACKへ観測したビットを書きます。これはvirtioデバイス側の通知原因を解除する操作です。IRQを受け取っただけでデバイスのinterruptが消えるとは考えないでください。
その後にICC_EOIR1_EL1とICC_DIR_EL1でGIC側の処理終了とdeactivateを行います。この実装はsplit EOIを使うため、二つを区別します。MMIOのInterruptACK、GICのEOI、usedの回収はそれぞれ異なる状態を進めます。一つが済んだことを残りの代用にはできません。ソースのhandle_guest_irqを読み、各書き込みがデバイスか割り込みコントローラーのどちらへ向くかを示してください。
ゲストの回収:usedから結果を読み直す
ゲストはIRQの配送を待ち、順序を整えてからused.idx、対応スロットのidとlen、status、データを読みます。GUEST_RECLAIMにはこの観測が記録されます。要求を出す前に知っていた期待値を表示しているのではなく、EL2が共有メモリへ返した値を読み直しています。データ全体のハッシュも計算し、転送が512バイト全体に及んだかを照合します。
usedのidは連鎖の先頭番号であり、ディスクのsector番号ではありません。slotもidもsectorも同じ0になる正常例では、誤って混同しても気付きにくくなります。九件のケースでslotが変わってもheadが同じまま使われる様子を比べ、それぞれの数値が何を識別するかを説明してください。完了を回収してから、次の要求へ同じ記述子とバッファを再利用します。
成功・要求エラー・構造エラーで期待を分ける
正常な読取はstatus 0、used.len 513の完了です。容量外や書込拒否はstatus 1、used.len 1の完了で、いずれもIRQと回収があります。一方、循環した連鎖はDEVICE_NEEDS_RESETを立て、usedは進めず、構成変更IRQを出します。ゲストはGUEST_CONFIG_CHANGEでstatus 79とInterruptStatus 2を確認し、usedを回収しません。IRQの有無だけで成功・失敗を判定すると、要求の完了とデバイスの構成変更を取り違えます。
完了を調べる順は、usedが進んだか、デバイスの通知原因が立ったか、GICへ注入されたか、ゲストが受領したか、通知を解除したか、結果を回収したかです。途中のどこで止まったかを特定してから修正します。ゲストの最後の表示がないという一つの症状に対して、データコピーとGIC設定を同時に変更すると原因を切り分けられません。
| 結果 | usedの公開 | 要求status | IRQとゲスト回収 |
|---|---|---|---|
| 読取成功 | len 513で進む | 0 | あり |
| 容量外・書込拒否 | len 1で進む | 1 | あり |
| 循環した記述子連鎖 | 進まない | 安全な返却先を確定できない | 構成変更IRQあり、used回収なし、デバイスstatus 79 |
実行できるRust:通知と回収を二重に数えない
次のホスト用コードは、結果を公開してから通知し、一度だけ回収するという状態の関係を表します。status 0も1も完了として通し、未公開や回収済みの結果はNoneにします。IRQの処理と要求の成功が別の軸であることを、二つのstatusを同じ順序で流して確かめます。
このモデルのboolは、実GICのPendingやActiveの状態を再現するものではありません。メモリバリア、例外ベクター、ICCレジスターも省いています。小さな不変条件を確かめるコードとして使い、実際のIRQ 40と回収は配布プロジェクトの収録で検証してください。モデルを通した値と機械から読み戻した値の証拠を取り違えないことも、実装を読むための基礎です。
#[derive(Debug, Default)]
struct Completion { published:u16, reclaimed:u16, interrupt:bool, status:Option<u8> }
impl Completion {
fn publish(&mut self,status:u8) {
assert_eq!(self.published,self.reclaimed);
self.status=Some(status);
self.published=self.published.wrapping_add(1);
}
fn notify(&mut self) {
assert_eq!(self.published.wrapping_sub(self.reclaimed),1);
self.interrupt=true;
}
fn ack(&mut self) { assert!(self.interrupt); self.interrupt=false; }
fn reclaim(&mut self)->Option<u8> {
if self.published==self.reclaimed { return None; }
self.reclaimed=self.reclaimed.wrapping_add(1);
self.status.take()
}
}
fn main() {
let mut c=Completion::default();
assert_eq!(c.reclaim(),None);
c.publish(0); assert!(!c.interrupt);
c.notify(); c.ack(); assert_eq!(c.reclaim(),Some(0));
assert_eq!(c.reclaim(),None);
c.publish(1); c.notify(); c.ack();
assert_eq!(c.reclaim(),Some(1));
assert_eq!((c.published,c.reclaimed),(2,2));
println!("success=completed IOERR=completed duplicate-reclaim=none");
}九件を読む:再利用と重複処理の違い
queueBoundaryでは一件ずつ公開、通知、回収を終えて次へ進みます。九件のQUEUE_TAKE、USED_PUBLISH、ゲストIRQ受領、GUEST_RECLAIMが対応し、スロット7の次に0を再利用します。同じスロットを二度使うこと自体は不具合ではありません。以前の結果を回収する前に上書きしたか、同じ公開を二回消費したかが問題です。
記録を読むときは全件数と、一件ごとの順序を両方見ます。配送数だけ合っても別の要求に対応する通知なら誤りです。デモの選択ケースに対応するソース情報、ELF、UARTハッシュをそろえ、再収録した場合はその成果物へ比較先を変えます。ブラウザで再生位置を進めた操作は実機の再実行ではなく、採取済み結果を読む操作です。 queueSpuriousでは、新しい要求のない重複通知をQUEUE_IDLEとして無視し、used公開もIRQも状態変更もありません。この入力でIRQがないのは正常です。構成変更の通知、要求完了の通知、処理すべき要求のない通知を、idxと通知原因から区別します。
演習:通知原因と回収位置を別々に調べる
演習では正常な一要求について、data、status、used要素、used.idx、デバイスinterrupt、LR0、ゲスト回収位置の変化を一枚の表にします。各行に、その変更を起こす関数を添えてください。次にInterruptACKを省いた場合と、used.idxを更新しない場合を区別し、どの状態が残り、どの観測で分かるかを予測します。
発展課題はIRQを受けたら即座に成功表示する実装の修正です。usedを読み、id、len、statusとバッファを検査してから結果を確定するよう設計してください。提出物には正常、IOERR完了、構造不正の三つの比較と、機械実走・ホスト試験の範囲を含めます。最後に一件のI/Oを入口から回収までソースでたどれれば、この第5弾の処理が一続きになります。