User Mode Linux HOWTO

User Mode Linux Core Team

1. UML概略

• 1.1 ユーザ モード リナックスは、なにが普通のリナックスと違うの？
• 1.2 ユーザ モード リナックスって、何をするためのもの？

2. カーネルとカーネルモジュールのコンパイル

• 2.1 カーネルのコンパイル
• 2.2 カーネルモジュールのコンパイルとインストール

3. ユーザ モード リナックスを起動し、ログインする

• 3.1 UML の起動
• 3.2 ログイン
• 3.3 動作例

4. 2G/2G問題

• 4.1 2G/2G問題ってなんだ？
• 4.2 問題点
• 4.3 解決策

5. シリアル回線とコンソールの設定

• 5.1 デバイスの指定
• 5.2 チャンネルの指定
• 5.3 設定例

6. ネットワーク（イーサネット）の設定

• 6.1 概略
• 6.2 コマンドライン書式
• 6.3 MACアドレスの指定
• 6.4 UMLログイン後の設定
• 6.5 mcast トランスポート層
• 6.6 TUN/TAP トランスポート層 uml_net 使用
• 6.7 TUN/TAP トランスポート層 ただし、uml_net を使わないで
• 6.8 Ethertapトランスポート層
• 6.9 スイッチデーモン
• 6.10 Slip トランスポート層
• 6.11 ホストLinux 側の設定

7. 複数UML間でのディスクイメージの共用

• 7.1 やってはいけないこと
• 7.2 COWファイルシステムの使用
• 7.3 注意点
• 7.4 その他
• 7.5 uml_moo : COW ファイルをディスクイメージに書き戻す

8. ファイルシステム（ディスクイメージ）を作る

• 8.1 ディスクイメージファイルの作成
• 8.2 UMLに認識させる：コマンドライン書式
• 8.3 UMLに認識させる：ブート後

9. ホストLinuxのファイルシステムをアクセス

• 9.1 hostfsを使う
• 9.2 hostfsをルートファイルシステムとして使う
• 9.3 hostfsのビルド

10. 制御コンソール

• 10.1 コマンド：version
• 10.2 コマンド：halt and reboot
• 10.3 コマンド：config
• 10.4 コマンド：remove
• 10.5 コマンド：sysrq
• 10.6 コマンド：help
• 10.7 コマンド：cad

11. カーネルデバッグへの応用

• 11.1 gdb の下でUML内部のLinuxカーネルを立ち上げる
• 11.2 gdb をUML内部のカーネルに接続する
• 11.3 カーネルモジュールをデバッグする
• 11.4 gdb 以外のデバッガを使う

12. カーネルデバッグ：実例

• 12.1 fsckがハングアップした場合
• 12.2 その第二章

13. トラブルとその対応策

• 13.1 Child nnnnn exited with signal 11
• 13.2 Segfault in padzero
• 13.3 Out of pty's in getmaster
• 13.4 Can't set up the umn device : "Failed to set slip line discipline"
• 13.5 Stack overflowed onto current_task page
• 13.6 Strange compilation errors when you build from source
• 13.7 UML hangs on boot after mounting devfs
• 13.8 A variety of panics and hangs with /tmp on a reiserfs filesystem
• 13.9 The compile fails with errors about conflicting types for 'open', 'dup', and 'waitpid'
• 13.10 UML doesn't work when /tmp is an NFS filesystem
• 13.11 UML hangs on boot when compiled with gprof support
• 13.12 syslogd dies with a SIGTERM on startup
• 13.13 TUN/TAP networking doesn't work on a 2.4 host
• 13.14 You can network to the host but not to other machines on the net
• 13.15 I have no root and I want to scream
• 13.16 UML build conflict between ptrace.h and ucontext.h
• 13.17 The UML BogoMips is exactly half the host's BogoMips
• 13.18 When you run UML, it immediately segfaults
• 13.19 Any other panic, hang, or strange behavior

14. トラブル：自力解決するなら

• 14.1 Case 1 : UML内部のカーネルがパニックしました！
• 14.2 Case 2 : トレーススレッドのパニック
• 14.3 Case 3 : ほかのスレッドによってトレーススレッドがパニックした
• 14.4 Case 4 : ハングアップ

15. 謝辞

• 15.1 コードとドキュメント
• 15.2 バグ出し協力
• 15.3 パッチ送付
• 15.4 活用事例
• 15.5 そのほか