User Mode Linux HOWTO

User Mode Linux Core Team

1. Introduction

• 1.1 How is User Mode Linux Different?
• 1.2 Why Would I Want User Mode Linux?

2. Compiling the kernel and modules

• 2.1 Compiling the kernel
• 2.2 Compiling and installing kernel modules

3. Running the kernel and logging in

• 3.1 Running UML
• 3.2 Logging in
• 3.3 Examples

4. UML on 2G/2G hosts

• 4.1 Introduction
• 4.2 The problem
• 4.3 The solution

5. Setting up serial lines and consoles

• 5.1 Specifying the device
• 5.2 Specifying the channel
• 5.3 Examples

6. Setting up the network

• 6.1 General setup
• 6.2 Userspace daemons
• 6.3 Specifying ethernet addresses
• 6.4 UML interface setup
• 6.5 Multicast
• 6.6 TUN/TAP with the uml_net helper
• 6.7 TUN/TAP with a preconfigured tap device
• 6.8 Ethertap
• 6.9 The switch daemon
• 6.10 Slip
• 6.11 Setting up the host yourself

7. Sharing Filesystems between Virtual Machines

• 7.1 A warning
• 7.2 Using layered block devices
• 7.3 Note!
• 7.4 Another warning
• 7.5 uml_moo : Merging a COW file with its backing file

8. Creating filesystems

• 8.1 Create the filesystem file
• 8.2 Assign the file to a UML device
• 8.3 Creating and mounting the filesystem

9. Host file access

• 9.1 Using hostfs
• 9.2 hostfs as the root filesystem
• 9.3 Building hostfs

10. The Management Console

• 10.1 version
• 10.2 halt and reboot
• 10.3 config
• 10.4 remove
• 10.5 sysrq
• 10.6 help
• 10.7 cad

11. Kernel debugging

• 11.1 Starting the kernel under gdb
• 11.2 Attaching gdb to the kernel
• 11.3 Debugging modules
• 11.4 Using alternate debuggers

12. Kernel debugging examples

• 12.1 The case of the hung fsck
• 12.2 Episode 2: The case of the hung fsck

13. What to do when UML doesn't work

• 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. Diagnosing Problems

• 14.1 Case 1 : Normal kernel panics
• 14.2 Case 2 : Tracing thread panics
• 14.3 Case 3 : Tracing thread panics caused by other threads
• 14.4 Case 4 : Hangs

15. Thanks

• 15.1 Code and Documentation
• 15.2 Flushing out bugs
• 15.3 Buglets and clean-ups
• 15.4 Case Studies
• 15.5 Other contributions