--- trunk/doc/guestoses.html	2007/10/08 16:18:06	5
+++ trunk/doc/guestoses.html	2007/10/08 16:18:11	6
@@ -13,7 +13,7 @@
 
 <!--
 
-$Id: guestoses.html,v 1.35 2005/04/27 15:32:40 debug Exp $
+$Id: guestoses.html,v 1.48 2005/06/04 01:11:01 debug Exp $
 
 Copyright (C) 2003-2005  Anders Gavare.  All rights reserved.
 
@@ -101,7 +101,7 @@
 
 <p>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
-<a href="netbsd-pmax-20040630.png"><img src="netbsd-pmax-20040630_small.png"></a>
+<a href="20050317-example.png"><img src="20050317-example_small.png"></a>
 
 <p>
 To install NetBSD/pmax onto a harddisk image in the emulator, follow these
@@ -223,19 +223,17 @@
 	$ <b>dd if=/dev/zero of=nbsd_arc.img bs=1024 count=1 seek=900000</b>
 
 </pre>
-  <li>Download a NetBSD/arc CDROM image from ftp:<pre>
+  <li>Download a NetBSD/arc 1.6.2 CDROM image from ftp:<pre>
 	<a href="ftp://ftp.netbsd.org/pub/NetBSD/iso/1.6.2/arccd.iso">ftp://ftp.netbsd.org/pub/NetBSD/iso/1.6.2/arccd.iso</a>
 
 </pre>
-  <li>Download a NetBSD/arc installation (ramdisk) kernel,
-	and gunzip it:<pre>
-	<a href="ftp://ftp.netbsd.org/pub/NetBSD/NetBSD-1.6.2/arc/binary/kernel/netbsd.RAMDISK.gz">ftp://ftp.netbsd.org/pub/NetBSD/NetBSD-1.6.2/arc/binary/kernel/netbsd.RAMDISK.gz</a>
-
-</pre>
   <li>Start the emulator using this command line:<pre>
-	$ <b>gxemul -E arc -e pica -b -d nbsd_arc.img -d arccd.iso netbsd.RAMDISK</b>
+	$ <b>gxemul -E arc -e pica -x -b -d nbsd_arc.img -d bc:arccd.iso \
+	  -j arc/binary/kernel/netbsd.RAMDISK.gz</b>
 
 </pre>
+	(Try removing <tt>-x</tt> if you have problems with the xterm.)
+    <p>
   <li>From now on, you have to use your imagination, as there is no
 	automatic installation program for NetBSD/arc. Here are some tips
 	and hints on how you can proceed with the install:<pre>
@@ -245,7 +243,7 @@
 	$ <b>newfs /dev/sd0a</b>
 	$ <b>mount /dev/sd0a /mnt</b>
 	$ <b>cd /mnt</b>
-	$ <b>for a in /mnt2/arc/binary/sets/*.tgz; do tar xvzpf $a; done</b>
+	$ <b>for a in /mnt2/arc/binary/sets/*.tgz; do echo $a; tar xzpf $a; done</b>
 	$ <b>cd dev; sh MAKEDEV all</b>
 	$ <b>cd ../etc; echo "rc_configured=YES" &gt;&gt; rc.conf</b>
 	$ <b>cat > /mnt/etc/fstab</b>
@@ -268,14 +266,10 @@
 image, using the following command:
 <p>
 <pre>
-	$ <b>gxemul -E arc -e pica -b -d nbsd_arc.img netbsd-GENERIC</b>
+	$ <b>gxemul -E arc -e pica -xb -d nbsd_arc.img netbsd-GENERIC</b>
 
 </pre>
 
-<p>
-Using <b>-b</b> (enabling dynamic binary translation), as in the instructions
-above, is not 100% stable. If you experiment weird crashes, try removing that
-option and try again.
 
 
 
@@ -363,15 +357,14 @@
 	$ <b>dd if=/dev/zero of=nbsd_hpcmips.img bs=1024 count=1 seek=1990000</b>
 
 </pre>
-  <li>Download the installation kernel (and gunzip it) and an ISO
-	image of NetBSD 2.0 for hpcmips:<pre>
-	<a href="ftp://ftp.netbsd.org/pub/NetBSD/NetBSD-2.0/hpcmips/installation/">ftp://ftp.netbsd.org/pub/NetBSD/NetBSD-2.0/hpcmips/installation</a>/<a href="ftp://ftp.netbsd.org/pub/NetBSD/NetBSD-2.0/hpcmips/installation/netbsd.gz">netbsd.gz</a>
+  <li>Download the NetBSD 2.0 for hpcmips ISO image:<pre>
 	<a href="ftp://ftp.se.netbsd.org/pub/NetBSD/iso/2.0/">ftp://ftp.se.netbsd.org/pub/NetBSD/iso/2.0</a>/<a href="ftp://ftp.se.netbsd.org/pub/NetBSD/iso/2.0/hpcmipscd.iso">hpcmipscd.iso</a>
 
 </pre>(You may want to choose a mirror closer to you, if .se is slow.)
   <p>
   <li>Start the installation like this:<pre>
-	$ <b>gxemul -E hpc -e mobilepro800 -b -X -d nbsd_hpcmips.img -d hpcmipscd.iso netbsd</b>
+	$ <b>gxemul -E hpc -e mobilepro800 -b -X -d nbsd_hpcmips.img  \
+	  -d b:hpcmipscd.iso -j hpcmips/installation/netbsd.gz</b>
 
 </pre>
 	and proceed like you would do if you were installing NetBSD on a real
@@ -432,9 +425,6 @@
 	$ <b>dd if=/dev/zero of=nbsd_cobalt.img bs=1024 count=1 seek=1999000</b>
 
 </pre>
-  <li>Install NetBSD/pmax 2.0 according to instructions further up
-	on this page.
-  <p>
   <li>Download the generic kernel for Cobalt (and gunzip it) and
 	the 2.0 ISO image:<pre>
 	<a href="ftp://ftp.se.netbsd.org/pub/NetBSD/NetBSD-2.0/cobalt/binary/kernel/netbsd-GENERIC.gz">ftp://ftp.se.netbsd.org/pub/NetBSD/NetBSD-2.0/cobalt/binary/kernel/netbsd-GENERIC.gz</a>
@@ -442,6 +432,9 @@
 
 </pre>(You may want to choose a mirror closer to you, if .se is slow.)
   <p>
+  <li>Install NetBSD/pmax 2.0 according to instructions further up
+	on this page.
+  <p>
   <li>Start NetBSD/pmax like this:<pre>
 	$ <b>gxemul -b -Edec -e3max -d nbsd_pmax.img -d cobaltcd.iso -d nbsd_cobalt.img</b>
 
@@ -473,6 +466,7 @@
 	root device (default wd0a): <b>wd0d</b>
 	dump device (default wd0b): <b>none</b>
 	file system (default generic): <b>ffs</b>
+	init path (default /sbin/init):     <i>(just press enter here)</i>
 </pre>
 
 
@@ -501,7 +495,7 @@
 TODO...
 
 <pre>
-cd /x; ftp -i ftp.se.netbsd.org
+cd /tftpboot; ftp -i ftp.se.netbsd.org
 ..
 cd pub/NetBSD/NetBSD-2.0/sgimips/binary/sets
 mget *.tgz
@@ -564,9 +558,9 @@
 
 </pre>
   <li>You now need to make an ISO image of the entire directory you downloaded.
-	I recommend using <b>mkisofs</b> for that purpose. If you don't already
-	have mkisofs installed on your system, you need to install that in
-	order to do this.<pre>
+	I recommend using <tt>mkisofs</tt> for that purpose. If you don't
+	already have <tt>mkisofs</tt> installed on your system, you need
+	to install it in order to do this.<pre>
 	$ <b>mkisofs -o openbsd_pmax_2.8.iso ftp.se.openbsd.org/pub/OpenBSD/2.8/pmax</b>
 
 </pre>
@@ -574,8 +568,9 @@
 	$ <b>gxemul -E dec -e 3max -b -d obsd_pmax.img -d b:simpleroot28.fs -j bsd -d c:openbsd_pmax_2.8.iso</b>
 
 </pre>
-	(If you add -X, you will run with the graphical framebuffer. This is <i>REALLY</i> slow
-	because the console has to scroll a lot during the install. I don't recommend it.)
+	(If you add <tt><b>-X</b></tt>, you will run with the graphical
+	framebuffer. This is <i>REALLY</i> slow because the console has to
+	scroll a lot during the install. I don't recommend it.)
   <p>
   <li>Go on with the installation as you would do if you were installing on a real machine.
 	If you are not used to the OpenBSD installer, then this will most likely
@@ -619,9 +614,7 @@
 	# <b>mount /</b>
 	# <b>passwd root</b>
 
-	# <b>cd /</b>
-	# <b>mount -t cd9660 /dev/rz2c /mnt</b>
-	# <b>sh</b>
+	# <b>cd /; mount -t cd9660 /dev/rz2c /mnt; sh</b>
 	# <b>for a in /mnt/[xX]*; do tar zxvf $a; done</b>
 	# <b>ln -s /usr/X11R6/bin/Xcfbpmax /usr/X11R6/bin/X</b>
 	# <b>ln -s /dev/fb0 /dev/mouse</b>
@@ -647,17 +640,14 @@
 </pre>
 
 <p>
-OpenBSD/pmax seems to work fine with dynamic binary translation (enabled 
-by the <b>-b</b> command line option).
+(Normally, you would be asked about which root device to use (<tt>rz0</tt>),
+but using <b><tt>-o '-aN'</tt></b> supresses that.)
 
 <p>
-(Normally, you would be asked about which root device to use (rz0), but 
-using -o '-aN' supresses that.)
-<p>
 When asked for which terminal type to use, when logging in as root,
-enter <b>rcons</b> if you are using the graphical framebuffer,
-<b>vt100</b> for text-mode.
-<br>Use <b>startx</b> to start X windows.
+enter <b><tt>rcons</tt></b> if you are using the graphical framebuffer,
+<b><tt>vt100</tt></b> for text-mode.
+<br>Use <b><tt>startx</tt></b> to start X windows.
 
 
 
@@ -699,15 +689,14 @@
 </pre>
 
   <li>You now need to make an ISO image of the entire directory you downloaded.
-	I recommend using <b>mkisofs</b> for that purpose. If you don't already
-	have mkisofs installed on your system, you need to install that in
-	order to do this.<pre>
+	I recommend using <tt>mkisofs</tt> for that purpose. If you don't
+	already have <tt>mkisofs</tt> installed on your system, you need
+	to install it in order to do this.<pre>
 	$ <b>mkisofs -o openbsd_arc_2.3.iso ftp.se.openbsd.org/pub/OpenBSD/</b>
 
 </pre>
   <li>Start the emulator using this command line:<pre>
-	$ <b>gxemul -X -b -E arc -e pica -d obsd_arc.img -d openbsd_arc_2.3.iso \
-	    ftp.se.openbsd.org/pub/OpenBSD/2.3/arc/bsd.rd.elf</b>
+	$ <b>gxemul -X -b -E arc -e pica -d obsd_arc.img -d b:openbsd_arc_2.3.iso -j 2.3/arc/bsd.rd</b>
 
 </pre>
 	and proceed like you would do if you were installing OpenBSD
@@ -724,11 +713,6 @@
 
 </pre>
 
-<p>
-(The <b>-b</b> command line option enables dynamic binary translation,
-which isn't always 100% stable, so if things seem buggy you might want
-to try to remove that from the command line.)
-
 
 
 
@@ -746,11 +730,6 @@
 <font color="#ff0000">NOTE: I haven't succeeded with this yet.</font>
 
 <p>
-<font color="#0000f0">
-[&nbsp;2005-02-09: There is no stable release yet of OpenBSD/sgi, but there
-are -current snapshots available on ftp sites.&nbsp;]</font>
-
-<p>
 GXemul does not yet emulate the AHC PCI SCSI controller in the O2, so 
 another emulated machine must be used as the nfs root server, and the
 emulated O2 machine must boot as a
@@ -759,27 +738,30 @@
 
 <p>
 <ol>
-  <li><a href="#netbsdinstall">Install NetBSD/pmax 1.6.2</a> or some other
-	similar OS inside the emulator. This will be the "nfs server" machine.
+  <li><a href="#netbsdinstall">Install NetBSD/pmax 2.0 from CDROM</a>
+	(or install some other similar OS) inside the emulator. This will 
+	be the "nfs server" machine. Create a 600 MB <tt>/tftpboot</tt>
+	partition during the installation.
   <p>
   <li>Configure the nfs server machine to act as an nfs server.<pre>
-	# <b>echo hostname=blahblah &gt;&gt; /etc/rc.conf</b>
-	# <b>echo ifconfig_le0="inet 10.0.0.2" &gt;&gt; /etc/rc.conf</b>
+	# <b>echo hostname=server &gt;&gt; /etc/rc.conf</b>
+	# <b>echo ifconfig_le0=\"inet 10.0.0.2\" &gt;&gt; /etc/rc.conf</b>
 	# <b>echo nameserver 10.0.0.254 &gt;&gt; /etc/rc.conf</b>
 	# <b>echo 10.0.0.254 &gt; /etc/mygate</b>
-	# <b>mkdir /x; echo /x -maproot=root 10.0.0.1 &gt; /etc/exports</b>
+	# <b>echo /tftpboot -maproot=root 10.0.0.1 &gt; /etc/exports</b>
 	# <b>echo rpcbind=YES &gt;&gt; /etc/rc.conf</b>
 	# <b>echo nfs_server=YES &gt;&gt; /etc/rc.conf</b>
 	# <b>echo mountd=YES &gt;&gt; /etc/rc.conf</b>
 	# <b>echo bootparamd=YES &gt;&gt; /etc/rc.conf</b>
-	# <b>printf "client root=10.0.0.2:/x \\\n swap=10.0.0.2:/x/swap\n" &gt; /etc/bootparams</b>
+	# <b>printf "client root=10.0.0.2:/tftpboot \\\n swap=10.0.0.2:/tftpboot/swap\n" &gt; /etc/bootparams</b>
 	# <b>echo 10.0.0.1 client &gt; /etc/hosts</b>
 
-	Reboot. Then download the OpenBSD/sgi distribution:
+	Reboot. Then download the OpenBSD/sgi distribution:  (NOTE: This
+	takes quite some time, even if you have a fast network connection.)
 
-	# <b>cd /x; ftp -i ftp.se.openbsd.org</b>
+	# <b>cd /tftpboot; ftp -i ftp.se.openbsd.org</b>
 	...
-	<b>cd pub/OpenBSD/snapshots/sgi</b>
+	<b>cd pub/OpenBSD/3.7/sgi</b>
 	<b>mget *</b>
 
 	# <b>sh</b>
@@ -844,7 +826,6 @@
 
 
 
-
 <p><br>
 <a name="ultrixinstall"></a>
 <h3>Installing Ultrix/RISC in GXemul:</h3>
@@ -866,17 +847,17 @@
         $ <b>dd if=/dev/zero of=rootdisk.img bs=1024 count=1 seek=800000</b>
 
 </pre>
-  <li>Place your Ultrix installation media in your CDROM drive. (I'm assuming
-        it is called /dev/cd0c here, replace that with the name of your
-        CDROM drive, or the name of a .iso image file.)
-        Then, start the emulator like this:<pre>
+  <li>Place your Ultrix installation media in your CDROM drive.
+	(On FreeBSD and similar systems, it is called <tt>/dev/cd0c</tt>.
+	Replace that with the name of your CDROM drive, or the name of a
+	.iso image file.) Then, start the emulator like this:<pre>
         $ <b>gxemul -X -b -M64 -E dec -e 3max -d rootdisk.img -d bc:/dev/cd0c -j vmunix</b>
 
 </pre>
   <li>Once the first stage of the installation is done (restoring the root
 	filesystem), you need to restart the emulator, booting from the 
 	new rootdisk, to continue the installation process.
-	This is done by removing the bootflag ('b') from the second
+	This is done by removing the bootflag ('<tt>b</tt>') from the second
 	diskimage argument:<pre>
         $ <b>gxemul -X -b -M64 -E dec -e 3max -d rootdisk.img -d c:/dev/cd0c -j vmunix</b>
 
@@ -891,44 +872,56 @@
 
 <p>
 Ultrix mostly seems to work with dynamic binary translation (enabled by 
-the <b>-b</b> command line option). If you have a very fast
+the <b><tt>-b</tt></b> command line option). If you have a very fast
 host machine, and use bintrans, you might experience a weird timer related
 bug, which makes it impossible to logon to the system. It is triggered
 when the emulation goes faster than any real DECstation machine was 
-capable of running. A temporary workaround is to add <b>-I33000000</b>
+capable of running. A temporary workaround is to add <b><tt>-I33000000</tt></b>
 to fix the emulated clock speed to 33 million instructions per emulated
-second. (When using -CR4400, -I16000000 should be used instead.)
+second. (When using <tt><b>-CR4400</b></tt>, <b><tt>-I16000000</tt></b> 
+should be used instead.)
 
 <p>
-You can experiment with adding <b>-Z2</b> (for emulating a 
-dual-headed workstation) or even <b>-Z3</b> (tripple-headed), and also the
-<b>-Y2</b> option for scaling down the framebuffer windows by a factor 2x2.
-There is also a <b>-z</b> option for supplying names of X11 displays to 
-use. The following example starts Ultrix on an emulated tripple-headed 
-workstation, on three different displays (remote1:0.0, localhost:0.0, and 
-remote2:0.0), using no scaledown:<pre>
+You can experiment with adding <b><tt>-Z2</tt></b> (for emulating a 
+dual-headed workstation) or even <b><tt>-Z3</tt></b> (tripple-headed), and 
+also the <b><tt>-Y2</tt></b> option for scaling down the framebuffer 
+windows by a factor 2x2.
+There is also a <b><tt>-z</tt></b> option for supplying names of X11 
+displays to use. The following example starts Ultrix on an emulated
+tripple-headed workstation, on three different displays (<tt>remote1:0.0</tt>,
+<tt>localhost:0.0</tt>, and <tt>remote2:0.0</tt>), using no scaledown:<pre>
         $ <b>gxemul -M64 -bN -E dec -e 3max -jgenvmunix -d rootdisk.img \
-            -XZ3 -z remote1:0.0 -z localhost -z remote2:0.0</b>
+            -XZ3 -z remote1:0.0 -z localhost:0.0 -z remote2:0.0</b>
 </pre>
 
 <p>
+The photo below shows a single Ultrix session running tripple-headed in
+GXemul on an Alpha 21164PC, with displays on a Sun Ultra1 (to the left),
+on the Alpha itself (in the middle), and on an HP700/RX X-terminal (8-bit
+color depth, running off the Alpha) to the right.
+
+<p>
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+<a href="20041209-ultrix-tripplehead.jpg"><img src="20041209-ultrix-tripplehead_small.jpg"></a>
+
+<p>
 The X11 displays may differ in bit depth and endianness. Unfortunately, 
 there is no way yet to set the scaledown factor on a per-window basis, so 
 the scaledown factor affects all windows.
 
 <p>
-(If you didn't use -Z<i>n</i> during the installation, and 
-compiled your own /vmunix, then it will not contain support for multiple 
-graphics cards. To overcome this problem, use the generic kernel, <b>-j 
-genvmunix</b>, whenever you are running the emulator with a different 
-setup than the one you used when Ultrix was installed.)
+(If you didn't use <tt><b>-Z<i>n</i></b></tt> during the installation, and 
+compiled your own <tt>/vmunix</tt>, then it will not contain support for 
+multiple graphics cards. To overcome this problem, use the generic kernel,
+<tt><b>-j genvmunix</b></tt>, whenever you are running the emulator with a 
+different setup than the one you used when Ultrix was installed.)
 
 <p>
 A note for the historically interested: OSF/1 for MIPS was quite similar
 to Ultrix, so that is possible to run as well.  If you are unsuccessful
 in installing Ultrix or OSF/1 directly in the emulator, you can always
 install it on your real machine onto a real SCSI disk, and then copy the
-contents of that SCSI disk into a file (using <b>dd(1)</b>), and use
+contents of that SCSI disk into a file (using <b><tt>dd(1)</tt></b>), and use
 that file as a disk image file in the emulator.
 
 
@@ -998,10 +991,6 @@
 Once you are logged in as root, running <b>xinit</b> will start the X11 
 environment.
 
-<p>
-Sprite works fine with dynamic binary translation (enabled by
-adding <b>-b</b> to the command line options).
-
 
 
 
@@ -1014,10 +1003,10 @@
 unstable. During my tests, even pressing the wrong key during the install
 (for example the wrong cursor key) can cause a kernel Oops.
 I <i>think</i> this has to do with interrupts from the serial controller.
-Hopefully using the -U command line option will reduce the risk for such 
-crashes. (I haven't had time to come up with a clean solution to this yet;
-it feels like a buffer overflow in Linux' serial driver for the 5000/200,
-but it is also likely that it is a bug in GXemul.)
+Hopefully using the <tt><b>-U</b></tt> command line option will reduce the 
+risk for such crashes. (I haven't had time to come up with a clean
+solution to this yet; it feels like a buffer overflow in Linux' serial 
+driver for the 5000/200, but it is also likely that it is a bug in GXemul.)
 </font>
 
 <p>
@@ -1060,9 +1049,9 @@
 
 <p>
 Debian GNU/Linux on DECstation works reasonably fine with dynamic
-binary translation, enabled by the <b>-b</b> command line option. (Without
-this option, the emulator might be less buggy, but also too slow to be 
-useful when running Linux as a guest OS.)
+binary translation, enabled by the <b><tt>-b</tt></b> command line option. 
+(Without this option, the emulator might be less buggy, but also too slow 
+to be useful when running Linux as a guest OS.)
 
 <p>
 (If you want to, you can try <b>-X</b> instead of <b>-o 'console=ttyS3'</b> on
@@ -1136,10 +1125,10 @@
 <a href="http://www.linux-mips.org/">linux-mips</a> has
 support for keyboards now, on DECstation 5000/200, so it is
 possible to run Debian GNU/Linux with framebuffer/keyboard.
-(Add -X (or -XY2) and remove the console=ttyS3 option.)
-He has made a kernel available here:
-<a href="http://home.tal.org/~milang/o2/patches/vmlinux-2.4.29-rc2-r3k-mipsel-decstation">
-http://home.tal.org/~milang/o2/patches/vmlinux-2.4.29-rc2-r3k-mipsel-decstation</a>
+(Add <b><tt>-X</tt></b> (or <b><tt>-XY2</tt></b>) and remove the
+<b><tt>console=ttyS3</tt></b> option.) He has made a kernel available here:
+<a href="http://home.tal.org/~milang/o2/kernels/vmlinux-2.4.29-rc2-r3k-mipsel-decstation">
+http://home.tal.org/~milang/o2/kernels/vmlinux-2.4.29-rc2-r3k-mipsel-decstation</a>
 It has other problems (ethernet doesn't seem to work, for
 example), but at least it doesn't Oops that often.&nbsp;]
 
@@ -1153,8 +1142,8 @@
 <h3>Running Redhat Linux for DECstation in GXemul:</h3>
 
 <font color="#ff0000">NOTE: This is experimental, and <i>extremely</i>
-unstable. Read the note about '-U' in the section on how to install 
-Debian.
+unstable. Read the note about <b><tt>-U</tt></b> in the section on how to 
+install Debian.
 </font>
 
 <p>