体系ガイド · 発展

RustでGICv3を設定する:仮想割り込みの入口

QEMUで実測したGICv3の設定を読み、EL2がlist registerへ仮想割り込みを用意する前提と状態を学びます。

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

更新日

この記事の目次
  1. 到達目標:注入前の前提を説明する
  2. QEMUの機械条件を固定する
  3. 物理側・仮想側・CPU側の条件を分ける
  4. 実測トレース:設定からPendingへ
  5. 一つのlist registerを上書きしない
  6. 実行できるRust:符号化と受付の契約
  7. 設定不備を最終ログだけで推測しない
  8. 演習:番号と状態を別々に検査する
  9. この記事をロゲイアに質問する理解を確かめる

到達目標:注入前の前提を説明する

第4弾では、EL2からEL1へ移るだけでなく、実際のGICv3仮想割り込みをゲストへ届けます。この章はその入口である設定を扱います。配布ソースexamples/rust-hypervisor-wave4のgic_setup、bootstrap、injectを読み、実測のGIC_READYとENTERを比較してください。仮想割り込み番号をログへ印字しただけの模擬実行ではなく、QEMUのGICとゲストの例外処理を使う構成です。

対象は信頼する一つのEL1ゲストと一つのvCPUです。EL2とゲストは教材用のRAMを共有します。Linux、virtio、複数VM、悪意のあるゲストからの隔離を実装したものではありません。この範囲を先に固定すると、どのレジスターがゲストへの配送を成立させるかを集中して読めます。仮想化という名前だけから、汎用ハイパーバイザの機能まで存在すると推測しないでください。

QEMUの機械条件を固定する

収録はQEMU 8.2.2、virt-8.2、cortex-a57、TCG、CPU一個、RAM 128MiBで行います。machineにはvirtualization=on、secure=off、gic-version=3を指定します。GICの種類を省略した別の起動条件と混ぜると、同じRustソースでも前提が変わります。バージョン付きの機械名とCPUモデルを含む完全なコマンドを、実行ファイルのハッシュと組にして確認してください。

画面の再生は、保存されたUARTとレジスター値を読む操作です。ソースを編集した後に新しい機械実行を行う操作とは区別します。配布されるqemu-recording.jsonにはコマンド、ソースの対応、ELFのハッシュ、標準出力が含まれます。再生された一行に対して、どのソースと設定の観測かをたどれることが重要です。画面上で条件を選んだことだけを、新しいQEMUが実行された証拠にしないでください。

物理側・仮想側・CPU側の条件を分ける

gic_setupは仮想タイマーの満了をEL2へ通知する物理IRQ(PPI27)の準備と、仮想CPUインターフェースの準備を行います。ICH_HCR_EL2は1に設定され、仮想インターフェースを有効にします。ICH_VMCR_EL2には優先度などとsplit EOIの条件を用意し、ゲスト側はICC_CTLR_EL1へ2を設定します。設定した値の文字列を暗記するより、どの条件が配送、優先度、完了処理に関係するかを分類してください。

bootstrapで記録されるHCR_EL2は0x80000019です。この教材ではAArch64ゲストとstage-2の設定に加え、物理IRQをEL2で扱う経路に関係します。仮想割り込みのpendingと、ゲストCPUがIRQを受け付けるかは別の条件です。ゲストのDAIFによるmaskや優先度設定も確認します。注入に成功したことだけで直ちにゲストハンドラーへ入ると考えず、途中にある受付条件を一つずつ追います。

実測トレース:設定からPendingへ

irqNormalの実測では、GIC_READYがICH_VTR_EL2とICH_VMCR_EL2の読み戻しを記録し、ENTERがHCR_EL2を記録します。次のINJECTではINTID 40に対しLR0が0x5080000000000028です。状態を示す上位二ビットは1、すなわちPendingです。下位の番号が40であることと、状態がPendingであることを分けて読みます。レジスター全体が番号だけを表すわけではありません。

ICH_VMCR_EL2は書いた式と読み戻しが同じ表示になるとは限りません。記録では0xff4c020aが観測されています。読み戻しの値を実測として保持し、都合の良い期待値で置き換えないでください。表のLRは収録した実行からの値で、ホスト用テストの計算結果と照合できます。ただしホストの計算が一致しても、GICの有効化や実際の例外配送まで証明したことにはなりません。

観測点実測または判定意味
GIC_READYICH_VMCR_EL2 = 0xff4c020a設定後の読み戻し
ENTERHCR_EL2 = 0x80000019ゲスト実行前の条件
INJECTINTID = 40注入する番号
LR00x5080000000000028状態ビットはPending

一つのlist registerを上書きしない

配布実装は、利用できる全list registerを動的に割り当てるスケジューラーではなく、LR0を使う小さな実験です。virtual_irq_lrは番号が1019以下であることと、現在の状態ビットがInvalidであることを調べます。PendingやActiveが残っているLR0へ新しい要求を書き込むと、未完了の配送を失います。空き判定ではレジスター全体がゼロかではなく、状態ビットを確認する点が重要です。

正常系は空のLR0への40の注入です。境界として0と1019の符号化を確認し、1020以降の特別な番号を拒否します。この入力検査が通ることと、その番号に必要なすべてのデバイス構成が済むことは異なります。失敗系では占有中のLR0と予約範囲を与え、レジスターを書き換える前に拒否することを確かめます。単にエラーの文字列を見るだけでなく、既存の要求を保つ契約として読みます。

実行できるRust:符号化と受付の契約

次のコードは、配布lib.rsの受付規則を独立したホスト用プログラムへ取り出したものです。AArch64のシステムレジスターへアクセスせず、通常のRustでコンパイルして実行できます。優先度、Group 1、Pending、番号のビットを合成し、境界と占有状態をassertで確かめます。このテストの成功を、実機のGICレジスターへ書き込んだ証拠として説明してはいけません。

最後のassertは、状態がInvalidでも他のビットが残るLR値を受け付ける例です。GICの配送完了後にレジスター全体がゼロになる必要はありません。maskを掛けて必要なフィールドを読む設計は、レジスター処理の多くに共通します。ホストの純粋関数による検査と、QEMUでの実測を組み合わせることで、算術の誤りと機械設定の誤りを別々に調べられます。

rust
#[derive(Debug, PartialEq)]
enum Reject { ReservedId, Busy }
fn prepare(id: u64, lr: u64) -> Result<u64, Reject> {
    if id > 1019 { return Err(Reject::ReservedId); }
    if (lr >> 62) & 3 != 0 { return Err(Reject::Busy); }
    Ok((1 << 62) | (1 << 60) | (0x80 << 48) | id)
}
fn main() {
    assert_eq!(prepare(40, 0), Ok(0x5080_0000_0000_0028));
    assert!(prepare(0, 0).is_ok());
    assert!(prepare(1019, 0).is_ok());
    assert_eq!(prepare(1020, 0), Err(Reject::ReservedId));
    assert_eq!(prepare(40, 1 << 62), Err(Reject::Busy));
    assert_eq!(prepare(40, 2 << 62), Err(Reject::Busy));
    assert!(prepare(40, 0x1080_0000_0000_0028).is_ok());
    println!("normal=0x{:016x} boundaries=ok", prepare(40, 0).unwrap());
}

設定不備を最終ログだけで推測しない

ゲストのACKが現れない場合、LRに要求がない、仮想インターフェースが無効、ゲストがIRQをmaskしている、例外ベクターが違うなど複数の原因が考えられます。まずINJECTの存在とLRの状態を確認し、次にCPUと優先度の受付条件、最後にハンドラーの入口を調べます。DONEがないことを、直ちにEL1へ移れていない問題と決め付けないでください。

収録済みのmaskedケースは、Pendingで保持される状態を読むための対照です。ゲストのIRQ maskを外す前後でLRと配送数を比較します。物理側のタイマー割り込みを無効にした実験とは区別してください。この段階ではGICの設定と受付条件を調べ、次のIRQの章でacknowledge、EOI、deactivateの往復を追います。入口と出口の責任を分けると、未配送と未完了の違いが見えます。

演習:番号と状態を別々に検査する

演習では40、1019、1020という番号と、Invalid、Pending、Activeという状態を組み合わせた表を作ります。どの組が受け付けられるかを先に予測し、ホスト用コードで確かめてください。拒否の理由が番号か占有かを分けて記録します。次に実測irqNormalでLRの番号フィールドと状態フィールドを読み、符号化の計算と対応づけます。全体の16進数だけを暗記しないことが課題です。

提出物には完全なQEMUコマンド、参照したELFハッシュ、設定の読み戻し、INJECTのLR、ゲストACKの有無を含めます。発展課題ではmaskedとnormalを比較し、同じPendingでもすぐ受理される場合と保持される場合がある理由を説明します。実験を再収録しない場合は収録の再生だと明記し、変更したソースを動かしたという主張と分けてください。証拠の範囲まで説明できれば設定の理解が深まります。

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

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

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

学習コースから次を選ぶ