--- UserModeLinux-HOWTO.sgml.0.0.4 Tue Dec 7 19:27:26 1999 +++ UserModeLinux-HOWTO.sgml Sat Mar 4 00:51:53 2000 @@ -9,7 +9,7 @@ User Mode Linux HOWTO <author>User Mode Linux Core Team -<date>v0.0.4, Tue Dec 7 17:55:59 EST 1999 +<date>v0.0.5, Sat Mar 4 00:44:00 EST 2000 <abstract> This document describes the use and abuse of Jeff Dike's User Mode Kernel: a port of the Linux kernel as a normal Intel Linux process. @@ -69,18 +69,24 @@ <item> You can debug the User Mode Linux like any normal process. <item> You can run gprof (profiling) and gcov (coverage testing). <item> You can play with your kernel without breaking things. +<item> You can use it as a sandbox for testing new apps. +<item> You can try new development kernels safely. +<item> You can run different distributions simultaneously. <item> It's extremely fun. </enum> <sect1>Getting User Mode Linux <p>The official User Mode Linux web page is at - <url url="http://www.mv.com/ipusers/karaya/uml/uml.html" - name="http://www.mv.com/ipusers/karaya/uml/uml.html">. + <url url="http://user-mode-linux.sourceforge.net" + name="http://user-mode-linux.sourceforge.net">. <p>From here you can get all the bits you need to try out User Mode Linux. +<p>This SourceForge site hosts downloads, a CVS tree, mailing list +info, and much more. + <sect>Installing User Mode Linux <p> @@ -88,7 +94,8 @@ <p>First of all, your host kernel will need to support the ptrace extensions. For 2.2 kernels, this involves a fairly painless patch -which looks like the following (this is already in 2.3 kernels): +which looks like the following (this patch has been included in the +2.3 kernel series since 2.3.21): <tscreen><verb> --- linux-2.2/arch/i386/kernel/entry.S.orig Tue Oct 19 10:16:46 1999 @@ -138,31 +145,37 @@ <p> Compiling the user mode kernel is just like compiling any other -kernel. Let's go through the steps, using 2.3.29 (current as of this +kernel. Let's go through the steps, using 2.3.48 (current as of this writing) as an example: <enum> <item> Download the latest UML patch from - <url url="http://www.mv.com/ipusers/karaya/uml/uml.html" - name="http://www.mv.com/ipusers/karaya/uml/uml.html">. + <url url="http://sourceforge.net/project/filelist.php?group_id=429" + name="http://sourceforge.net/project/filelist.php?group_id=429">. - In this example, the file is umk-2.3.29.patch.gz. + In this example, the file is patch-2.3.48_devfs.bz2. <item> Download the matching kernel from your favourite kernel mirror, such as: - <url url="ftp://ftp.ca.kernel.org/pub/kernel/v2.3/linux-2.3.29.tar.bz2" - name="ftp://ftp.ca.kernel.org/pub/kernel/v2.3/linux-2.3.29.tar.bz2">. + <url url="ftp://ftp.ca.kernel.org/pub/kernel/v2.3/linux-2.3.48.tar.bz2" + name="ftp://ftp.ca.kernel.org/pub/kernel/v2.3/linux-2.3.48.tar.bz2">. <item> Make a directory and unpack the kernel into it. +<tscreen><verb> + $ cd /usr/src/ + $ tar -xzvf linux-2.3.48.tar.bz2 + $ mv linux linux-usermode +</verb></tscreen> + <item> Apply the patch using <tscreen><verb> $ cd /usr/src/linux-usermode - $ zcat umk-2.3.29.patch.gz | patch -p1 + $ cat patch-2.3.48_devfs.bz2 | bunzip2 - | patch -p1 </verb></tscreen> <item> Do a normal `make config'; you won't get asked any questions, @@ -191,7 +204,7 @@ <p> There is another way to build a root filesystem: you can make a copy -of your duplocate filesystem if your disk is less than half full. To +of your duplicate filesystem if your disk is less than half full. To do this: <enum>