体系ガイド · 発展

Rustで起動する:リンク配置と最初のスタック

起動入口、EL2用スタック、BSS、ゲスト領域を分離し、QEMUで動くベアメタルRustの実行前提を検査します。

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

更新日

この記事の目次
  1. 到達目標:mainより前の責任を説明する
  2. ELFの入口とロード先を分ける
  3. スタックと静的領域を衝突させない
  4. BSSとno_stdの初期化境界
  5. 配置検査をホスト上で実行する
  6. 実行記録を、生成物までたどる
  7. 正常・境界・失敗を順番に試す
  8. 演習:入口からEL2初期化までを説明する
  9. この記事をロゲイアに質問する理解を確かめる

到達目標:mainより前の責任を説明する

通常のRustプログラムでは、OSが実行ファイルを読み込み、スタックなどを用意してから標準ライブラリの入口へ制御を渡します。この教材の小さなハイパーバイザには、そのOSがありません。配布プロジェクトの起動コードとリンカスクリプトを読むときは、「Rustの関数が呼べた」ことを出発点にせず、その前に誰がPC、SP、初期メモリを用意したかを一つずつ記録します。目標は、起動ログの最初の行が出るまでの依存関係を説明することです。

実行対象はQEMUのArm virtマシン、1個のCPU、1個のEL1ゲストです。これはLinuxを起動する汎用ハイパーバイザではありません。ブラウザのQEMU実行記録では、収録した設定とソースに対する結果を追います。ソースを変更して確かめる場合は、配布プロジェクトを手元でビルドして再収録してください。記録の再生と新しい機械実行を区別すると、画面の説明を実験の証拠として正しく扱えます。

ELFの入口とロード先を分ける

リンカスクリプトは、入力オブジェクトのコードやデータを最終イメージのどこへ置くかを決めます。ENTRYで示した入口シンボルと、.textの配置アドレスは関係しますが同じ概念ではありません。QEMUの起動方法がELFのロード可能セグメントを使うのか、生のバイト列を決まった場所へ置くのかによっても条件が変わります。配布版のコマンドと実際のELFを組にして確認し、別の起動手順のアドレスを混ぜないでください。

たとえば、ソースでは起動関数が先頭に見えても、リンク時のセクション回収や配置順で最終アドレスは変化します。入口用セクションを保持する指定、境界シンボル、整列条件は、単なる装飾ではなく実行契約です。再現時は生成物のシンボルとセグメントを検査し、入口が実行可能なロード領域内にあることを確かめます。ログの文字列が同じであっても、別のイメージを実行したなら同じ試験にはなりません。

スタックと静的領域を衝突させない

最初のスタックは起動コードが設定します。AArch64の関数呼出し規約に合わせた整列を維持し、スタックの予約範囲がコード、BSS、変換テーブル、ゲストの領域と重ならないようにします。スタックは上端から下向きに使われるため、上端のアドレスだけを見て「空いている」と判断してはいけません。予約した下端も含めて範囲として比較し、例外フレームを積む余裕を残すことが必要です。

ゲストへ入る前に使うEL2のスタックと、ゲストが使うEL1のスタックには別の役割があります。同じ数値を使って一度動いたとしても、ゲストの処理がEL2の保存状態を書き壊す設計では、例外から戻ったときに破綻します。この最小構成では、領域表に所有者と用途を書き、呼出し時の一時領域と恒久的に保存するCPU状態を区別します。複数CPUへ拡張するなら、CPUごとのスタックも追加で必要になります。

領域配布版の用途検査する境界
.text / .rodata / .dataEL2とEL1を含む同一ELFのコードと初期データ入口0x40080000とロード領域
.bss / STAGE2ゼロ初期化領域と4KiB整列の変換表__bss_startから__bss_endまで
EL2スタック32KiBを予約、例外フレームも使用__host_stack_topと下向きの使用範囲
EL1スタック16KiBを別に予約__guest_stack_top、ホスト領域との非重複

BSSとno_stdの初期化境界

ファイルに値を持つ.dataと、ゼロ初期化を要求する.bssは役割が異なります。配布版のロード経路と起動コードがどの範囲を初期化するかを読み、静的変数を使う前にゼロ化が成立していることを確認します。Rustの型が安全でも、まだ有効なメモリ状態を作っていない起動段階の誤りまで自動で修復するわけではありません。境界シンボルの差分が期待したBSSサイズになるかを見る試験も有効です。

no_stdは、OS向けの標準ライブラリを使わないという選択です。これだけで入口、パニック処理、メモリアロケータ、UART出力が自動的に実装されるわけではありません。この配布版のような小さな処理では、固定領域と明示的な状態を優先すると、ヒープの初期化を別課題にできます。パニック時には正常終了の印を出さず、停止理由を区別して記録します。無限待機に入る場合も、試験側では成功ログの有無を判定してください。

配置検査をホスト上で実行する

次のコードは、配布イメージの固定値を代用するコードではなく、範囲の検査方法を確かめる独立したRustプログラムです。半開区間を使うと、ある領域の終了位置と次の開始位置が等しい場合を、重なりなしとして扱えます。加算のオーバーフローを先に検査することも重要です。巨大なサイズが小さな終了位置へ折り返すと、見かけ上は整列していても配置検査を通過してしまいます。

正常例は接する二つの範囲、境界例は16バイト整列の上端、失敗例は重なりと整数の折返しです。この検査が通っても、EL2で起動できることや変換テーブルが正しいことまでは証明しません。一方、失敗したままQEMUへ進んでも、原因を低レベルの例外処理から探し直すだけになります。機械実行前に決められる条件と、実行しないと観測できない条件を分けて試験します。

rust
// Independent host-side placement check; no machine execution.
fn end(base: u64, size: u64) -> Option<u64> { base.checked_add(size) }
fn disjoint(a: (u64,u64), b: (u64,u64)) -> bool {
    a.1 <= b.0 || b.1 <= a.0
}
fn main() {
    assert_eq!(end(0x4000, 0x1000), Some(0x5000));
    assert!(disjoint((0x4000,0x5000), (0x5000,0x6000)));
    assert!(!disjoint((0x4000,0x5001), (0x5000,0x6000)));
    assert_eq!(end(u64::MAX, 1), None);
    assert_eq!(0x6000u64 % 16, 0);
}

実行記録を、生成物までたどる

起動の実行記録では、QEMUの版、固定したmachine名、CPUモデル、メモリ量、CPU数、起動引数を先に確認します。virtという名前だけでは、将来のQEMUで同じ機械モデルになることまで保証しません。配布版の記録が使う版付きmachine名と実行コマンドをそのまま使い、変更した引数は比較記録へ残します。ホストの速さによる待ち時間の違いと、ゲストが実行した命令の違いも分けて扱います。

ソースのコミットまたはファイルのハッシュと、実行イメージのハッシュを結び付けると、「この行を変更した結果」という主張を検査できます。Web上の強調行は、その収録版に対する位置です。違う版の同じ行番号に同じ処理があるとは限りません。再現時には自分のソース、ビルドコマンド、イメージ、UARTログを一組で保存し、公開記録との一致箇所と相違箇所を具体的に挙げてください。

正常・境界・失敗を順番に試す

正常系では配布版を変更せずビルドし、起動時の例外レベルとEL2初期化へ到達した印を確認します。境界系では、予約範囲のすぐ隣に小さな静的領域を加え、リンカが意図した余白を残すかを検査します。スタックの最小容量を推測で本番値にせず、例外フレームを含めた使用範囲を考えてください。容量を増やして偶然動いたという結果だけでは、以前の破損箇所を説明できません。

失敗系は別の作業コピーで、整列違反または意図的な領域衝突を作り、ビルド時か検査時に検出できることを確かめます。ランダムに壊すより、検出したい不変条件を一つ選んで破る方が有益です。Webの閲覧完了、確認問題の合格、ローカル実装の完了申告は別の記録です。ローカル課題を完了としたときも、何を実行して何を確認したかを手元の記録へ残してください。

演習:入口からEL2初期化までを説明する

配布プロジェクトのリンカスクリプトと起動コードから、入口、コード、BSS、EL2スタック、EL1スタックの範囲表を作ってください。次に、最初のRust関数の直前までに成立すべき条件を、命令と対応付けます。各条件について、静的な生成物検査で確かめたのか、QEMUの出力で観測したのかを書き分けます。値を転記するだけでなく、その値を決めたソースの位置を一つずつ示すことが課題です。

発展課題では、小さなデータ領域を追加して再ビルドし、境界シンボル、イメージのハッシュ、UARTの起動系列がどのように変わるかを予測します。実測との差があれば、コンパイラ、リンカ、ロード、実行のどの段階で予測が外れたかを調べてください。次章では、準備したスタックとメモリの上にEL2の例外入口を置きます。起動できることと例外から復帰できることは、異なる達成条件として扱います。

QEMU実行記録:EL2の起動と初期化

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

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

学習コースから次を選ぶ