体系ガイド · 発展

RustのIRQ往復:acknowledge・EOI・deactivate

ゲストのIRQハンドラーでIAR、EOI、DIRを順に実行し、LRのPending・Active・Invalidを実測で追います。

この記事をロゲイアに質問する確認問題3問に進むこれまでの誤答を復習する

更新日

この記事の目次
  1. 到達目標:受理と完了を別の出来事として読む
  2. IARの読み取りは番号の表示だけではない
  3. split EOIでは優先度低下と非Active化を分ける
  4. 実測トレース:同じ番号の三つの状態
  5. mask中のPendingを消失と誤解しない
  6. 実行できるRust:完了方式の状態契約
  7. 例外から戻る経路も実行の一部である
  8. 演習:EOIを完了と決め付けない
  9. この記事をロゲイアに質問する理解を確かめる

到達目標:受理と完了を別の出来事として読む

仮想割り込みをLRへ用意しただけでは、ゲストが処理を完了したことにはなりません。この章ではEL1のIRQベクターからhandle_guest_irqへ入り、IARで番号を受け取り、EOIとDIRを行い、通常の処理へ戻る経路を読みます。実測のGUEST_ACK、GUEST_EOI、GUEST_EOI_DIRを順に確認し、同じ割り込みの状態がどこで変わるかを説明します。

EL2とEL1の間では、観測用のHVCも使われています。HVCのログがあること自体をIRQ例外の証拠とせず、その前にゲストのIRQベクターとIARの読み取りがあるかを確認します。配布ソースのhandle_guest_irqとhandle_syncを対応させて読むと、ゲストが行う完了操作と、EL2が状態を記録する操作を区別できます。ログの名前だけでCPUがどこにいるかを推測しないことが重要です。

IARの読み取りは番号の表示だけではない

ゲストはICC_IAR1_EL1を読み、受け付けた割り込み番号を得ます。実測irqNormalでは40が返り、LRの状態がPendingからActiveへ変わります。受理された番号を後続のEOIとDIRで使うことが重要です。最初に注入したつもりの定数を無条件で書き戻す設計では、別の番号が返った場合に誤った完了操作を行ってしまいます。

処理中のActiveは、要求が消えた状態ではありません。同じLR0へ次の割り込みを上書きできる空きでもありません。教材の受付関数は、Pending、Active、PendingとActiveの複合状態を占有中として拒否します。正常な配送数だけを見ると、一回目の受理後に残った状態を見落とす可能性があります。LRの状態とハンドラーの進行を一緒に観測することで、再注入の前提を確認します。

split EOIでは優先度低下と非Active化を分ける

この実装ではsplit EOI modeを使います。ICC_EOIR1_EL1への書き込みは優先度の処理を進めますが、それだけで仮想割り込みをInvalidへ戻すとは限りません。続くICC_DIR_EL1への書き込みでdeactivateを行います。教材の実測ではEOI後もLRはActiveのままで、DIR後にInvalidになります。EOIという名前を「すべて完了した」の同義語にしないでください。

状態を確認するため、ゲストはEOIとDIRの間にもHVCを行います。この観測点により、二つの操作が同じ意味ではないことを見られます。機械の設定によって完了方式は異なるため、この章の説明は配布コードのsplit EOI設定と組にします。他のOSや別モードのコードへ、そのまま同じ書き込み順をコピーして正しいと考えるのではなく、設定と完了方式を対応づけて確認します。

実測トレース:同じ番号の三つの状態

irqNormalのLRは、注入時0x5080000000000028、受理時0x9080000000000028、EOI後も同じActive、DIR後0x1080000000000028です。上位二ビットを取り出すと1、2、2、0になり、Pending、Active、Active、Invalidと読めます。番号40と他の属性は残ります。最後の値がゼロでないことを、処理の失敗と判断してはいけません。

GUEST_EOI_DIRでは配送数1が記録され、DONEでも1が確認できます。これが一回の要求を一回処理したという観測です。表は実際に収録されたirqNormalの状態を抜き出しています。カウンターの時刻値と異なり、この実験のLR符号化は固定した設定に対する検査対象になります。ただし別の優先度や番号を選べば全体値は変わるため、状態ビットを読む方法も必ず併用します。

ログLR0状態
INJECT0x5080000000000028Pending
GUEST_ACK0x9080000000000028Active
GUEST_EOI0x9080000000000028Activeのまま
GUEST_EOI_DIR0x1080000000000028Invalid、配送数1

mask中のPendingを消失と誤解しない

irqMaskedでは、ゲストがDAIFのIRQ maskを保持した状態で仮想割り込みを用意します。LRはPendingとなりますが、ゲストのハンドラーへはまだ入りません。maskを外した後に受理と完了が進みます。これは配送が消えた例ではなく、受付条件が満たされるまで保持された例です。Pendingであることと、処理できることを別々に観測してください。

正常系は40の一回配送、境界は通常番号の上端の例、反復は完了後に再び注入する例です。失敗系は予約番号や占有中への再注入を拒否します。反復では二回目の前に最初のDIRが完了していることを確かめます。配送数が増えたという結果だけでは、未完了の要求を上書きしていないか分かりません。番号、状態、回数、順序を組み合わせて判断します。

実行できるRust:完了方式の状態契約

次の独立したホスト用Rustコードは、Pending、Active、Invalidの簡略化した状態を使います。実際のGICレジスターへアクセスせず、split EOIの契約だけを小さく検査します。mask中はPendingを保ち、受理でActiveへ移り、EOIではActiveを保ち、deactivateでInvalidへ戻ります。GIC全体の全状態や優先度の入れ子をモデル化したコードではありません。

特に注目するのはActiveへの再注入を拒否するassertと、Invalidに対するdeactivateを拒否するassertです。状態の遷移には前提条件があります。実機の動作をこの関数の通りだと推測するのではなく、実測したLRの列と同じ基本契約を満たすかを照合します。純粋な状態テストで設計の誤りを早く見つけ、例外ベクターやレジスターアクセスはQEMU実行で検証する分担になります。

rust
#[derive(Debug, PartialEq, Clone, Copy)]
enum State { Invalid, Pending, Active }
fn inject(s: State) -> Result<State, &'static str> {
    if s != State::Invalid { return Err("busy"); } Ok(State::Pending)
}
fn acknowledge(s: State, masked: bool) -> State {
    if s == State::Pending && !masked { State::Active } else { s }
}
fn eoi(s: State) -> State { s } // split EOI: priority drop only
fn deactivate(s: State) -> Result<State, &'static str> {
    if s != State::Active { return Err("not active"); } Ok(State::Invalid)
}
fn main() {
    let p = inject(State::Invalid).unwrap();
    assert_eq!(acknowledge(p, true), State::Pending);
    let a = acknowledge(p, false);
    assert_eq!(a, State::Active);
    assert_eq!(eoi(a), State::Active);
    assert_eq!(inject(a), Err("busy"));
    assert_eq!(deactivate(a), Ok(State::Invalid));
    assert_eq!(deactivate(State::Invalid), Err("not active"));
    println!("Pending -> Active -> Active after EOI -> Invalid after DIR");
}

例外から戻る経路も実行の一部である

IRQハンドラーは、その場でログを残すだけでなく、通常処理を再開するための状態を保つ必要があります。配布のベクターコードがレジスターを保存し、Rustの処理へ渡し、戻る流れを確認してください。IARやDIRが正しくても、復帰先やレジスターの保存が壊れていれば、その後のゲスト実行は正しく続きません。DONEまで到達する観測を、完了の状態と併せて読みます。

また、観測用のHVCを増やすと処理のタイミングが変わる場合があります。ログの行数を増やせば常に同じ実験になるわけではありません。変更後はELFとソースの識別情報を更新して再収録し、以前の実測と混ぜないようにします。再開できること、次の要求を処理できること、停止条件へ到達することを順に確かめると、単発のIRQ成功を継続実行へ結び付けられます。

演習:EOIを完了と決め付けない

演習ではirqNormalの四つのLRを読み、状態フィールドだけを取り出して表へ書きます。次にGUEST_EOIの直後に新しい要求を入れられるか予測し、ホスト契約の再注入検査と比べます。配布の正しい実行を改変して危険な上書きを試す前に、状態モデルで拒否の理由を説明してください。番号が同じでも、PendingとActiveでは意味が違うことを言葉で整理します。

続いてirqMaskedとirqRepeatedを読み、要求の保持と完了後の再利用を対比します。提出物には各ログの順序、LRの状態、配送数、再開を示す後続イベントを含めてください。発展課題ではsplit EOIの設定とゲストのEOIR、DIRの対応をソースから示します。観測のためのHVCと、実際のGIC操作を別の列に書くと、説明用ログが割り込みそのものだという混同を防げます。

QEMU実行記録:GICv3の仮想割り込み

実験の途中状態を読み込み中…

読了と問題の結果を、言語ごとにこのブラウザへ保存します。

学習コースから次を選ぶ