到達目標:ゲストのレジスター操作を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 / 0x008 | Magic / Version 2 / DeviceID 2 |
| 機能 | 0x010・0x014 / 0x020・0x024 | デバイス機能の読取 / 受諾機能の書込 |
| キュー | 0x030 / 0x038 / 0x044 | 選択 / 長さ8 / Ready |
| アドレス | 0x080・0x084 / 0x090・0x094 / 0x0a0・0x0a4 | 記述子 / avail / used |
| 通知 | 0x050 / 0x060 / 0x064 | QueueNotify / 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を消すことも検査します。状態を一つの数値として見るだけでなく、その数値へ進む前提をテストへ書き出す練習になります。
#[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の下位アドレスを書き換える場合です。検査済みの領域を固定する契約と、リセットして設定し直す経路の違いを説明してください。提出物には状態遷移表、失敗の位置、再現コマンドをまとめます。実際に再収録した結果と、保存された収録を読んだ結果は区別し、ホストの状態テストが証明する範囲も明示します。