体系ガイド · 発展

Rustでvirtio-mmioを実装する:レジスターから要求の入口へ

EL1のMMIOアクセスをEL2で受け、機能交渉、キュー準備、通知の受付条件をRustと実QEMUの記録で追います。

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

更新日

この記事の目次
  1. 到達目標:ゲストのレジスター操作をEL2で受ける
  2. 対応範囲:読み取り専用の一つのブロックデバイス
  3. レジスターを役割ごとに読む
  4. 初期化:状態の数値より成立した条件を追う
  5. MMIO例外:命令を一回分だけエミュレートする
  6. 実行できるRust:初期化の関門を独立に試す
  7. 記録を読む:初期化の成立とデータ転送を分ける
  8. 演習:順序の誤りと値の誤りを切り分ける
  9. この記事をロゲイアに質問する理解を確かめる

到達目標:ゲストのレジスター操作をEL2で受ける

第5弾では、ゲストの入出力要求をEL2の小さなデバイスへ届けます。入口はIPA 0x0a000000に置いたvirtio-mmioレジスターです。EL1のドライバーがここを読み書きすると、stage-2の例外を経てEL2のemulate_mmioへ入り、Deviceの状態が変わります。通常のRAMへの書き込みと、デバイスの操作として解釈される書き込みの違いを、同じゲストの命令から追ってください。

配布ソースはexamples/rust-hypervisor-wave5です。lib.rsのDevice::readとDevice::writeがレジスターの契約を持ち、main.rsのinitialize_deviceがゲスト側の初期化順を示します。機械上の例外処理と、通常のRustで試験できる状態遷移を分けた構成です。Web画面は採取済みのQEMU実行を再生し、編集したソースを新しく動かす作業は配布プロジェクトで行います。

対応範囲:読み取り専用の一つのブロックデバイス

この実装はmodern MMIOのVersion 2、DeviceID 2を返し、読み取り専用のROとVERSION_1という二つの機能ビットを提示します。キューは0番の一つ、長さは8に固定されています。機能を絞ることで、どの操作が要求の受付条件を成立させるかを読めます。virtioの名前が付いていても、任意のドライバーやLinuxを動かす互換性まで確立した構成ではありません。

EL2と信頼する一つのEL1ゲストは教材用RAMを共有します。アドレスや記述子の検査は実装しますが、悪意のあるゲストからEL2を隔離する製品ではありません。packed queue、間接記述子、任意のscatter-gather、EVENT_IDX、通知抑制は扱いません。仕様の一般的な仕組みと、この配布実装が受け付ける部分集合を分けて説明することが、再現可能な実験の出発点になります。

レジスターを役割ごとに読む

レジスターには、機械の識別、機能の交渉、キューの場所、通知、状態という異なる役割があります。DeviceFeaturesSelを変えるとDeviceFeaturesで読む32ビットのページが切り替わります。下位ページではROのbit 5、上位ページでは全体のbit 32に当たるbit 0を読みます。一つの32ビット値だけを見て、必要な機能がそろったと判断しないでください。

キューのアドレスは下位・上位32ビットのレジスターを組にして設定します。QueueReadyを立てた後は、実装がアドレスの変更を拒否します。要求を処理する途中で共有メモリの位置が変わると、検査した場所と実際に読む場所がずれるためです。表のオフセットはMMIO領域先頭からの距離であり、ゲストのRAM内に置くリングのアドレスとは別の値です。

役割オフセットこの実装での用途
識別0x000 / 0x004 / 0x008Magic / Version 2 / DeviceID 2
機能0x010・0x014 / 0x020・0x024デバイス機能の読取 / 受諾機能の書込
キュー0x030 / 0x038 / 0x044選択 / 長さ8 / Ready
アドレス0x080・0x084 / 0x090・0x094 / 0x0a0・0x0a4記述子 / avail / used
通知0x050 / 0x060 / 0x064QueueNotify / InterruptStatus / InterruptACK
状態・容量0x070 / 0x100・0x104累積status / 4セクターの容量

初期化:状態の数値より成立した条件を追う

initialize_deviceはリセット後にstatusを1、3へ進め、提示された二つの機能を選んでから11へ進めます。11はACKNOWLEDGE、DRIVER、FEATURES_OKの組合せです。この配布実装では受諾した機能の組が期待と一致することをDevice::writeが検査します。FEATURES_OKを立てたという書き込みだけで交渉成功とせず、状態の読み戻しも確認してください。

次に0番キューの長さと三つのアドレスを設定し、QueueReadyを1にします。Layout::validateが範囲、整列、領域の重なりを確認した後に、statusを15へ進めてDRIVER_OKを加えます。QueueNotifyを受け付けるのはReadyかつstatus 15の状態です。正常な通知を最後へ置く理由を、単なる手順の暗記ではなく、デバイスが安全に共有メモリを読める条件から説明します。

MMIO例外:命令を一回分だけエミュレートする

emulate_mmioは例外情報からアクセスしたIPA、レジスター番号、読み書きの方向を取り出します。この教材で許可するのは対象領域内の整列した32ビットアクセスです。読み出しならDevice::readの値を保存フレームへ返し、書き込みならDevice::writeへ値を渡します。QueueNotifyが有効なときにだけnotifyへ進むため、すべてのレジスター書き込みがI/O要求の実行になるわけではありません。

エミュレーションした命令の後へ戻るため、ELR_EL2を4バイト進めます。同じ命令へ戻れば、同じMMIO例外が繰り返されます。逆に、扱っていないアクセス幅を推測で処理してPCを進めると、命令の意味を取り違えたままゲストが続行します。失敗した入力を止める処理と、成功した命令の復帰処理を、ソース上の分岐と対応させてください。 例外を起こした命令のアドレスと、命令がアクセスしたデバイスのIPAは別です。ELR_EL2を4進める操作と、レジスターのオフセットを4進める操作を混同しないよう、二つのアドレスを別の列へ記録してください。

実行できるRust:初期化の関門を独立に試す

次のホスト用プログラムはDevice::writeの状態遷移から、機能交渉とキュー準備の関門を取り出したものです。単一ファイルとしてrustcで実行できます。MMIO例外やシステムレジスターは操作せず、指定した順序が通ることと、条件を飛ばした順序が拒否されることを確かめます。実際の例外配送はQEMUの記録と照合する別の検証です。

最初の失敗は状態0から15への飛び越し、次は機能が空のまま11へ進む操作、その次はReadyのない15への遷移です。失敗のたびに、何がまだ成立していないかを説明してください。最後はリセットが機能とReadyを消すことも検査します。状態を一つの数値として見るだけでなく、その数値へ進む前提をテストへ書き出す練習になります。

rust
#[derive(Debug, PartialEq)]
enum Reject { Order, Features, Queue }
struct Device { status: u32, features: [u32; 2], ready: bool }
impl Device {
    fn set_status(&mut self, next: u32) -> Result<(), Reject> {
        if next == 0 { self.status=0; self.features=[0;2]; self.ready=false; return Ok(()); }
        match (self.status, next) {
            (0,1) | (1,3) => {},
            (3,11) if self.features == [1<<5,1] => {},
            (3,11) => return Err(Reject::Features),
            (11,15) if self.ready => {},
            (11,15) => return Err(Reject::Queue),
            _ => return Err(Reject::Order),
        }
        self.status=next; Ok(())
    }
}
fn main() {
    let mut d=Device {status:0,features:[0;2],ready:false};
    assert_eq!(d.set_status(15),Err(Reject::Order));
    d.set_status(1).unwrap(); d.set_status(3).unwrap();
    assert_eq!(d.set_status(11),Err(Reject::Features));
    d.features=[1<<5,1]; d.set_status(11).unwrap();
    assert_eq!(d.set_status(15),Err(Reject::Queue));
    d.ready=true; d.set_status(15).unwrap();
    d.set_status(0).unwrap();
    assert_eq!((d.status,d.features,d.ready),(0,[0,0],false));
    println!("negotiation=ok queue-gate=ok reset=ok");
}

記録を読む:初期化の成立とデータ転送を分ける

正常な収録ではMMIO_READとMMIO_WRITEを追い、識別用レジスター、機能のページ切替、Ready、DRIVER_OKがそろうまでを確認します。その後にQueueNotify、QUEUE_TAKE、CHAIN_VALIDが続くかを見ます。Magicが読めたことは識別の成功であり、記述子を読み取った証拠とは別です。最終のDONEだけを見ると、どの段階まで成立したかが隠れます。

再現するときは選択ケースの完全なQEMUコマンド、ソース情報、ELFハッシュ、生UARTを組にして残します。ここで扱うデバイスはEL2のRust実装であり、QEMUに内蔵されたvirtio-blkをそのまま使用する実験ではありません。QEMUはCPUと例外・GICの実行環境を提供します。どの層を自作し、どの層を既存の実行環境に任せたかも説明に含めてください。

演習:順序の誤りと値の誤りを切り分ける

演習では、Readyより先にDRIVER_OKを設定する例と、機能の上位ページを受諾しない例を作ります。どのDevice::writeがどの理由で拒否するかを予測し、ホスト用テストで確認してください。次に正常な記録と比較して、最初に異なる状態を探します。最後の通知が失敗したという結果から、通知レジスター自体が壊れていると決め付けないことが課題です。

発展課題はReadyの後にdescの下位アドレスを書き換える場合です。検査済みの領域を固定する契約と、リセットして設定し直す経路の違いを説明してください。提出物には状態遷移表、失敗の位置、再現コマンドをまとめます。実際に再収録した結果と、保存された収録を読んだ結果は区別し、ホストの状態テストが証明する範囲も明示します。

QEMU実行記録:virtio-mmioとvirtqueue

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

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

学習コースから次を選ぶ