[gentoo-doc-cvs] cvs commit: uml.xml

[gentoo-doc-cvs] cvs commit: uml.xml

[Lukasz Damentko]

rane        05/10/03 22:53:50

  Modified:    xml/htdocs/doc/en uml.xml
  Log:
  LiveCD -> Installation CD, added license comment, no other content change

Revision  Changes    Path
1.23      +8 -5      xml/htdocs/doc/en/uml.xml

file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/uml.xml?rev=1.23&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/uml.xml?rev=1.23&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/uml.xml.diff?r1=1.22&r2=1.23&cvsroot=gentoo

Index: uml.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/uml.xml,v
retrieving revision 1.22
retrieving revision 1.23
diff -u -r1.22 -r1.23
--- uml.xml	5 Feb 2005 16:52:57 -0000	1.22
+++ uml.xml	3 Oct 2005 22:53:50 -0000	1.23
@@ -1,10 +1,11 @@
 <?xml version='1.0' encoding="UTF-8"?>
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/uml.xml,v 1.22 2005/02/05 16:52:57 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/uml.xml,v 1.23 2005/10/03 22:53:50 rane Exp $ -->
 
 <!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
 
 <guide link="/doc/en/uml.xml">
 <title>Gentoo Linux Developer's guide to system testing with User-Mode Linux</title>
+
 <author title="Editor">
   <mail link="g2boojum@gentoo.org">Grant Goodyear</mail>
 </author>
@@ -23,9 +24,11 @@
 user-mode linux for testing potentially system-breaking changes.
 </abstract>
 
+<!-- The content of this document is licensed under the CC-BY-SA license -->
+<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
 <license/>
 
-<version>0.10</version>
+<version>0.11</version>
 <date>2005-02-05</date>
 
 <chapter>
@@ -133,11 +136,11 @@
 Generating the <path>root_fs</path> file itself will be
 our last step.  First we will generate a Gentoo filesystem in
 an ordinary chroot.  We need the stage tarball available, which 
-could be downloaded separately, extracted from a liveCD, or 
-extracted from a liveCD .iso.  
+could be downloaded separately, extracted from an Installation CD, or 
+extracted from an Installation CD .iso.  
 </p>
 
-<pre caption="Mounting a liveCD .iso">
+<pre caption="Mounting an Installation CD .iso">
 # <i>mkdir /mnt/loop</i>
 # <i>mount -o loop /path/to/install-&lt;TAB&gt;.iso /mnt/loop</i>
 </pre>



-- 
gentoo-doc-cvs@gentoo.org mailing list

[gentoo-doc-cvs] cvs commit: uml.xml

[swift]

swift       05/11/17 17:19:55

  Modified:    xml/htdocs/doc/en uml.xml
  Log:
  #103026 and #110695 - Fix ubd, place sources elsewhere, plus additional information on networking

Revision  Changes    Path
1.24      +70 -14    xml/htdocs/doc/en/uml.xml

file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/uml.xml?rev=1.24&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/uml.xml?rev=1.24&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/uml.xml.diff?r1=1.23&r2=1.24&cvsroot=gentoo

Index: uml.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/uml.xml,v
retrieving revision 1.23
retrieving revision 1.24
diff -u -r1.23 -r1.24
--- uml.xml	3 Oct 2005 22:53:50 -0000	1.23
+++ uml.xml	17 Nov 2005 17:19:55 -0000	1.24
@@ -1,5 +1,5 @@
 <?xml version='1.0' encoding="UTF-8"?>
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/uml.xml,v 1.23 2005/10/03 22:53:50 rane Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/uml.xml,v 1.24 2005/11/17 17:19:55 swift Exp $ -->
 
 <!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
 
@@ -28,8 +28,8 @@
 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
 <license/>
 
-<version>0.11</version>
-<date>2005-02-05</date>
+<version>0.12</version>
+<date>2005-11-17</date>
 
 <chapter>
 <title>Obtaining User-Mode Linux</title>
@@ -50,17 +50,27 @@
 </p>
 
 <p>
-Installing user-mode linux is essentially identical to a normal kernel
-install.  First install the kernel sources (appropriately patched for
-user-mode linux), and then configure the user-mode linux kernel in the
-usual fashion. Since kernel 2.6.9, UML has been integrated in the vanilla
-kernel. 
+Most 2.6 kernels have UML support. Although you can use your current kernel
+sources, it might be wiser to keep the UML kernel tree(s) separate. After all,
+you'll be building a new kernel with a different configuration and you might
+want to have heterogenous systems on your main Linux system (several different
+UML kernels).
 </p>
 
-<pre caption="Installing UML kernel sources">
-<comment>(We'll install the vanilla 2.6 kernel, you can also use the usermode-sources)</comment>
-# <i>emerge sys-kernel/development-sources</i>
-# <i>cd /usr/src/linux</i>
+<p>
+So download a nice kernel tree (like the vanilla one from <uri
+link="http://www.kernel.org">kernel.org</uri>) and extract it to some local
+development location.
+</p>
+
+<p>
+Next, configure this UML kernel as you would do for any other system, but append
+<e>ARCH=um</e> so that the kernel build software knows that the kernel
+is meant to run as a guest process on the main system.
+</p>
+
+<pre caption="Building the UML kernel">
+# <i>cd /srv/aegis/src/uml-linux</i>
 # <i>make menuconfig <comment>ARCH=um</comment></i>
 # <i>make linux <comment>ARCH=um</comment></i>
 # <i>cp linux /usr/local/bin/linux</i>
@@ -168,9 +178,9 @@
 <p>
 Add any additional packages you desire.  Feel free to give your virtual
 Gentoo system a hostname, if you so desire.  In <path>/etc/fstab</path>
-you will want <path>/dev/ROOT</path> to be <path>/dev/ubd/0</path>, with
+you will want <path>/dev/ROOT</path> to be <path>/dev/ubda</path>, with
 a fs type of either ext2, ext3, or reiserfs.  Set <path>/dev/SWAP</path>
-to be <path>/dev/ubd/1</path>, and comment out <path>/dev/BOOT</path>.
+to be <path>/dev/ubdb</path>, and comment out <path>/dev/BOOT</path>.
 </p>
 
 <p>
@@ -261,6 +271,7 @@
 <chapter>
 <title>Networking</title>
 <section>
+<title>Using an Existing Network</title>
 <body>
 
 <p>
@@ -346,6 +357,51 @@
 
 </body>
 </section>
+<section>
+<title>Using a Virtual Network</title>
+<body>
+
+<p>
+Before you get all too excited, this is not a virtual private network. It is a
+network that is only accessible by the UML instances. The
+<c>usermode-utilities</c> package provides a tool called <c>uml_switch</c> which
+defines the end points of the switch.
+</p>
+
+<pre caption="Activating end points of a UML switch">
+<comment>(If the switch information should stay in the foreground:)</comment>
+$ <i>uml_switch -unix ~/tmp/switch.sock</i>
+
+<comment>(If it should be backgrounded:)</comment>
+$ <i>uml_switch -unix ~/tmp/switch.sock &amp;&gt; ~/tmp/switch.log &amp;</i>
+</pre>
+
+<p>
+To start the UML instances on the switch, run the next command. Your
+(virtual) network interface will be connected to the <c>uml_switch</c> process
+and will be using the given MAC address. 
+</p>
+
+<pre caption="Running first UML instance">
+$ <i>linux ubd0=first_rootfs ubd1=first_swapfs eth0=daemon,10:00:01:02:00:00,,~/tmp/switch.sock</i>
+</pre>
+
+<p>
+You can still connect the system to the existing network, or have a second
+process attached to both the virtual one and the existing one:
+</p>
+
+<pre caption="Running second UML instance">
+$ <i>linux ubd0=second_rootfs ubd1=second_swapfs eth0=daemon,10:00:01:02:00:01,,~/tmp/switch.sock \
+  eth1=tuntap,,,192.168.1.43</i>
+</pre>
+
+<p>
+More information about the tuntap setting can be found in the previous section.
+</p>
+
+</body>
+</section>
 </chapter>
 <chapter>
 <title>Testing the .iso</title>



-- 
gentoo-doc-cvs@gentoo.org mailing list

[gentoo-doc-cvs] cvs commit: uml.xml

[swift]

swift       05/12/16 15:54:54

  Modified:    xml/htdocs/doc/en uml.xml
  Log:
  Disambiguation of installation. A user reported that he went on by booting from the CD...

Revision  Changes    Path
1.25      +5 -5      xml/htdocs/doc/en/uml.xml

file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/uml.xml?rev=1.25&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/uml.xml?rev=1.25&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/uml.xml.diff?r1=1.24&r2=1.25&cvsroot=gentoo

Index: uml.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/uml.xml,v
retrieving revision 1.24
retrieving revision 1.25
diff -u -r1.24 -r1.25
--- uml.xml	17 Nov 2005 17:19:55 -0000	1.24
+++ uml.xml	16 Dec 2005 15:54:54 -0000	1.25
@@ -1,5 +1,5 @@
 <?xml version='1.0' encoding="UTF-8"?>
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/uml.xml,v 1.24 2005/11/17 17:19:55 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/uml.xml,v 1.25 2005/12/16 15:54:54 swift Exp $ -->
 
 <!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
 
@@ -28,8 +28,8 @@
 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
 <license/>
 
-<version>0.12</version>
-<date>2005-11-17</date>
+<version>0.13</version>
+<date>2005-12-16</date>
 
 <chapter>
 <title>Obtaining User-Mode Linux</title>
@@ -171,8 +171,8 @@
 </p>
 
 <p>
-Bootstrap and build the system in the usual fashion. Just follow the
-installation instructions :)
+Build the system in the usual fashion: chroot into <path>/mnt/gentoo</path> and
+follow the Gentoo installation instructions.
 </p>
 
 <p>



-- 
gentoo-doc-cvs@gentoo.org mailing list

[gentoo-doc-cvs] cvs commit: uml.xml

[Josh Saddler]

nightmorph    06/06/26 16:16:58

  Modified:             uml.xml
  Log:
  Updated UML guide for bug 137908

Revision  Changes    Path
1.26                 xml/htdocs/doc/en/uml.xml

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
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/uml.xml?rev=1.26&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/uml.xml.diff?r1=1.25&r2=1.26&cvsroot=gentoo

Index: uml.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/uml.xml,v
retrieving revision 1.25
retrieving revision 1.26
diff -u -r1.25 -r1.26
--- uml.xml	16 Dec 2005 15:54:54 -0000	1.25
+++ uml.xml	26 Jun 2006 16:16:58 -0000	1.26
@@ -1,5 +1,5 @@
 <?xml version='1.0' encoding="UTF-8"?>
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/uml.xml,v 1.25 2005/12/16 15:54:54 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/uml.xml,v 1.26 2006/06/26 16:16:58 nightmorph Exp $ -->
 
 <!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
 
@@ -28,24 +28,32 @@
 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
 <license/>
 
-<version>0.13</version>
-<date>2005-12-16</date>
+<version>0.14</version>
+<date>2006-06-26</date>
 
 <chapter>
 <title>Obtaining User-Mode Linux</title>
 <section>
 <body>
 
+<impo>
+Before you can use user-mode Linux, you <e>must</e> be using a non-NPTL
+profile, and you must be using &lt;<c>glibc</c>-2.4. Follow the instructions
+for <uri link="/doc/en/gentoo-upgrading.xml#instructions">changing
+profiles</uri>. You will need to run <c>emerge -e world</c> after switching to
+a non-NPTL profile.
+</impo>
+
 <p>
-As the user-mode linux website 
-(<uri>http://user-mode-linux.sourceforge.net</uri>) states, user-mode linux
+As the user-mode Linux website 
+(<uri>http://user-mode-linux.sourceforge.net</uri>) states, user-modeL linux
 allows a user to "run Linux inside itself".  Specifically,
 user-mode linux provides a virtual machine on which a user can "[r]un buggy
 software, experiment with new Linux kernels or distributions, and poke around
 in the internals of Linux, all without risking your main Linux setup." 
 Experimental changes to Gentoo core packages such as <e>sys-apps/baselayout</e>
 or <e>sys-libs/glibc</e> have the potential to break the system and render it 
-unbootable; with user-mode linux we can test these changes without having to
+unbootable; with user-mode Linux we can test these changes without having to
 worry about breaking the live system.
 </p>
 
@@ -93,11 +101,11 @@
 </pre>
 
 <p>
-For the user-mode linux kernel to properly boot a Gentoo system the 
+For the user-mode Linux kernel to properly boot a Gentoo system the 
 kernel needs to be configured to <e>not</e> automatically mount 
 <path>/dev</path> (devfs) by default. Also, you will almost certainly
 want to make sure that you have <e>tmpfs</e> (the "Virtual Memory 
-Filesystem") compiled in, since by default the Gentoo linux bootscripts
+Filesystem") compiled in, since by default the Gentoo Linux bootscripts
 store their information in a small tmpfs partition.
 (The binary kernels available from the user-mode website do automatically 
 mount <path>/dev</path>, and they don't have tmpfs compiled in; don't bother 
@@ -113,7 +121,7 @@
 </p>
 
 <p>
-It won't hurt to also install the user-mode linux tools.
+It won't hurt to also install the user-mode Linux tools.
 </p>
 
 <pre caption="Installing UML tools">
@@ -122,7 +130,7 @@
 
 <p>
 These tools facilitate networking (among other things) between the user-mode 
-linux virtual system and the host Linux system.
+Linux virtual system and the host Linux system.
 </p>
 
 </body>
@@ -251,15 +259,15 @@
 </pre>
 
 <p>
-User-mode linux uses xterms for the virtual consoles that 
+User-mode Linux uses xterms for the virtual consoles that 
 are run at boot time, so you need to make sure that the
-terminal from which you run user-mode linux has $DISPLAY
+terminal from which you run user-mode Linux has $DISPLAY
 properly set (along with proper xhost/xauth permissions).
 </p>
 
 <p>
-With any luck you should be able to log into your user-mode linux
-Gentoo system.  The only thing keeping this user-mode linux version
+With any luck you should be able to log into your user-mode Linux
+Gentoo system.  The only thing keeping this user-mode Linux version
 of Gentoo from being fully functional is networking from the virtual
 machine to the host.  
 </p>
@@ -298,7 +306,7 @@
 <comment>(If you receive a FATAL error here, try deleting /dev/net/tun and retry)</comment>
 # <i>modprobe iptable_nat</i>
 # <i>iptables -t nat -A POSTROUTING -o eth0 -j MASQUERADE</i>
-# <i>echo 1 > /proc/sys/net/ipv4/ip_forward</i>
+# <i>echo 1 &gt; /proc/sys/net/ipv4/ip_forward</i>
 </pre>
 
 <p>
@@ -410,8 +418,8 @@
 
 <p>
 Perhaps the true ideal of Gentoo Linux testing would be
-to boot the .iso with user-mode linux and do the complete
-Gentoo install from within the user-mode linux virtual system.
+to boot the .iso with user-mode Linux and do the complete
+Gentoo install from within the user-mode Linux virtual system.
 </p>
 
 <p>



-- 
gentoo-doc-cvs@gentoo.org mailing list

[gentoo-doc-cvs] cvs commit: uml.xml

[Josh Saddler]

nightmorph    06/11/17 21:07:40

  Modified:             uml.xml
  Log:
  added mem parameter to UML guide, bug 135821

Revision  Changes    Path
1.27                 xml/htdocs/doc/en/uml.xml

file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/uml.xml?rev=1.27&view=markup
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/uml.xml?rev=1.27&content-type=text/plain
diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/uml.xml?r1=1.26&r2=1.27

Index: uml.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/uml.xml,v
retrieving revision 1.26
retrieving revision 1.27
diff -u -r1.26 -r1.27
--- uml.xml	26 Jun 2006 16:16:58 -0000	1.26
+++ uml.xml	17 Nov 2006 21:07:40 -0000	1.27
@@ -1,5 +1,5 @@
 <?xml version='1.0' encoding="UTF-8"?>
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/uml.xml,v 1.26 2006/06/26 16:16:58 nightmorph Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/uml.xml,v 1.27 2006/11/17 21:07:40 nightmorph Exp $ -->
 
 <!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
 
@@ -28,8 +28,8 @@
 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
 <license/>
 
-<version>0.14</version>
-<date>2006-06-26</date>
+<version>0.15</version>
+<date>2006-11-17</date>
 
 <chapter>
 <title>Obtaining User-Mode Linux</title>
@@ -272,6 +272,13 @@
 machine to the host.  
 </p>
 
+<note>
+If you receive "No space left on device" errors, you may need to allocate more
+memory to your user mode system by appending <c>mem=xxxMB</c> to the end of the
+kernel thread line. For example: <c>linux ubd0=root_fs ubd1=swap_fs
+mem=128MB</c>.
+</note>
+
 </body>
 </section>
 </chapter>



-- 
gentoo-doc-cvs@gentoo.org mailing list

[gentoo-doc-cvs] cvs commit: uml.xml

[Jan Kundrat]

jkt         08/03/01 19:24:22

  Modified:             uml.xml
  Log:
  #211997, /etc/env.d/00basic belongs to baselayout and shouldn't be touched

Revision  Changes    Path
1.30                 xml/htdocs/doc/en/uml.xml

file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/uml.xml?rev=1.30&view=markup
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/uml.xml?rev=1.30&content-type=text/plain
diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/uml.xml?r1=1.29&r2=1.30

Index: uml.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/uml.xml,v
retrieving revision 1.29
retrieving revision 1.30
diff -u -r1.29 -r1.30
--- uml.xml	29 Nov 2006 15:48:57 -0000	1.29
+++ uml.xml	1 Mar 2008 19:24:22 -0000	1.30
@@ -1,5 +1,5 @@
 <?xml version='1.0' encoding="UTF-8"?>
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/uml.xml,v 1.29 2006/11/29 15:48:57 nightmorph Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/uml.xml,v 1.30 2008/03/01 19:24:22 jkt Exp $ -->
 
 <!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
 
@@ -28,8 +28,8 @@
 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
 <license/>
 
-<version>0.15</version>
-<date>2006-11-17</date>
+<version>0.16</version>
+<date>2008-03-01</date>
 
 <chapter>
 <title>Obtaining User-Mode Linux</title>
@@ -89,17 +89,23 @@
 </warn>
 
 <p>
-Make sure that <path>/usr/local/bin</path> is in your path. Edit
-<path>/etc/env.d/00basic</path> to that the PATH variable contains
-<path>/usr/local/bin</path> and rerun <c>env-update</c>:
+On a default Gentoo system, <path>/usr/local/bin</path> is in your <c>$PATH</c>.
+If it isn't, you should find a definition of <c>PATH</c> in the
+<path>/etc/profile</path> and fix it:
 </p>
 
-<pre caption="Editing 00basic">
-# <i>nano -w /etc/env.d/00basic</i>
-# <i>env-update</i>
-# <i>source /etc/profile</i>
+<pre caption="Verifying $PATH">
+$ <i>echo $PATH | grep /usr/local/bin</i>
 </pre>
 
+<pre caption="Sample definition of $PATH in /etc/profile">
+PATH="/usr/local/bin:/usr/bin:/bin:${PATH}"
+</pre>
+
+<p>
+Don't forget to run <c>source /etc/profile</c> for the change to take effect.
+</p>
+
 <p>
 For the user-mode Linux kernel to properly boot a Gentoo system the 
 kernel needs to be configured to <e>not</e> automatically mount 



-- 
gentoo-doc-cvs@lists.gentoo.org mailing list