Gentoo Archives: gentoo-doc-cvs

From: Josh Saddler <nightmorph@×××××××××××.org>
To: gentoo-doc-cvs@l.g.o
Subject: [gentoo-doc-cvs] cvs commit: uml.xml
Date: Mon, 26 Jun 2006 16:17:28
Message-Id: 20060626161659.0D35D64A6D@smtp.gentoo.org
1 nightmorph 06/06/26 16:16:58
2
3 Modified: uml.xml
4 Log:
5 Updated UML guide for bug 137908
6
7 Revision Changes Path
8 1.26 xml/htdocs/doc/en/uml.xml
9
10 file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/uml.xml?rev=1.26&content-type=text/x-cvsweb-markup&cvsroot=gentoo
11 plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/uml.xml?rev=1.26&content-type=text/plain&cvsroot=gentoo
12 diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/uml.xml.diff?r1=1.25&r2=1.26&cvsroot=gentoo
13
14 Index: uml.xml
15 ===================================================================
16 RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/uml.xml,v
17 retrieving revision 1.25
18 retrieving revision 1.26
19 diff -u -r1.25 -r1.26
20 --- uml.xml 16 Dec 2005 15:54:54 -0000 1.25
21 +++ uml.xml 26 Jun 2006 16:16:58 -0000 1.26
22 @@ -1,5 +1,5 @@
23 <?xml version='1.0' encoding="UTF-8"?>
24 -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/uml.xml,v 1.25 2005/12/16 15:54:54 swift Exp $ -->
25 +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/uml.xml,v 1.26 2006/06/26 16:16:58 nightmorph Exp $ -->
26
27 <!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
28
29 @@ -28,24 +28,32 @@
30 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
31 <license/>
32
33 -<version>0.13</version>
34 -<date>2005-12-16</date>
35 +<version>0.14</version>
36 +<date>2006-06-26</date>
37
38 <chapter>
39 <title>Obtaining User-Mode Linux</title>
40 <section>
41 <body>
42
43 +<impo>
44 +Before you can use user-mode Linux, you <e>must</e> be using a non-NPTL
45 +profile, and you must be using &lt;<c>glibc</c>-2.4. Follow the instructions
46 +for <uri link="/doc/en/gentoo-upgrading.xml#instructions">changing
47 +profiles</uri>. You will need to run <c>emerge -e world</c> after switching to
48 +a non-NPTL profile.
49 +</impo>
50 +
51 <p>
52 -As the user-mode linux website
53 -(<uri>http://user-mode-linux.sourceforge.net</uri>) states, user-mode linux
54 +As the user-mode Linux website
55 +(<uri>http://user-mode-linux.sourceforge.net</uri>) states, user-modeL linux
56 allows a user to "run Linux inside itself". Specifically,
57 user-mode linux provides a virtual machine on which a user can "[r]un buggy
58 software, experiment with new Linux kernels or distributions, and poke around
59 in the internals of Linux, all without risking your main Linux setup."
60 Experimental changes to Gentoo core packages such as <e>sys-apps/baselayout</e>
61 or <e>sys-libs/glibc</e> have the potential to break the system and render it
62 -unbootable; with user-mode linux we can test these changes without having to
63 +unbootable; with user-mode Linux we can test these changes without having to
64 worry about breaking the live system.
65 </p>
66
67 @@ -93,11 +101,11 @@
68 </pre>
69
70 <p>
71 -For the user-mode linux kernel to properly boot a Gentoo system the
72 +For the user-mode Linux kernel to properly boot a Gentoo system the
73 kernel needs to be configured to <e>not</e> automatically mount
74 <path>/dev</path> (devfs) by default. Also, you will almost certainly
75 want to make sure that you have <e>tmpfs</e> (the "Virtual Memory
76 -Filesystem") compiled in, since by default the Gentoo linux bootscripts
77 +Filesystem") compiled in, since by default the Gentoo Linux bootscripts
78 store their information in a small tmpfs partition.
79 (The binary kernels available from the user-mode website do automatically
80 mount <path>/dev</path>, and they don't have tmpfs compiled in; don't bother
81 @@ -113,7 +121,7 @@
82 </p>
83
84 <p>
85 -It won't hurt to also install the user-mode linux tools.
86 +It won't hurt to also install the user-mode Linux tools.
87 </p>
88
89 <pre caption="Installing UML tools">
90 @@ -122,7 +130,7 @@
91
92 <p>
93 These tools facilitate networking (among other things) between the user-mode
94 -linux virtual system and the host Linux system.
95 +Linux virtual system and the host Linux system.
96 </p>
97
98 </body>
99 @@ -251,15 +259,15 @@
100 </pre>
101
102 <p>
103 -User-mode linux uses xterms for the virtual consoles that
104 +User-mode Linux uses xterms for the virtual consoles that
105 are run at boot time, so you need to make sure that the
106 -terminal from which you run user-mode linux has $DISPLAY
107 +terminal from which you run user-mode Linux has $DISPLAY
108 properly set (along with proper xhost/xauth permissions).
109 </p>
110
111 <p>
112 -With any luck you should be able to log into your user-mode linux
113 -Gentoo system. The only thing keeping this user-mode linux version
114 +With any luck you should be able to log into your user-mode Linux
115 +Gentoo system. The only thing keeping this user-mode Linux version
116 of Gentoo from being fully functional is networking from the virtual
117 machine to the host.
118 </p>
119 @@ -298,7 +306,7 @@
120 <comment>(If you receive a FATAL error here, try deleting /dev/net/tun and retry)</comment>
121 # <i>modprobe iptable_nat</i>
122 # <i>iptables -t nat -A POSTROUTING -o eth0 -j MASQUERADE</i>
123 -# <i>echo 1 > /proc/sys/net/ipv4/ip_forward</i>
124 +# <i>echo 1 &gt; /proc/sys/net/ipv4/ip_forward</i>
125 </pre>
126
127 <p>
128 @@ -410,8 +418,8 @@
129
130 <p>
131 Perhaps the true ideal of Gentoo Linux testing would be
132 -to boot the .iso with user-mode linux and do the complete
133 -Gentoo install from within the user-mode linux virtual system.
134 +to boot the .iso with user-mode Linux and do the complete
135 +Gentoo install from within the user-mode Linux virtual system.
136 </p>
137
138 <p>
139
140
141
142 --
143 gentoo-doc-cvs@g.o mailing list