--- trunk/doc/guestoses.html 2007/10/08 16:20:58 32 +++ trunk/doc/guestoses.html 2007/10/08 16:21:17 34 @@ -10,9 +10,9 @@
  • Linux/QEMU_MIPS
  • Windows NT/MIPS -
  • NetBSD/macppc 3.0
  • NetBSD/bebox 19981119 +

    NOTE: +Some of these sections may not be relevant to this +specific release of GXemul, for example some of these +modes may be legacy modes that worked before but not any longer, +or are not yet working but could be in the future. +

    Some operating systems are listed with a version number less than what was available at the time of this GXemul release (e.g. NetBSD/prep). The reasons for this is because of incompleteness in @@ -812,7 +817,7 @@

    1. Create an empty harddisk image, which will be the root disk that you will install NetBSD/cats onto:
      -	dd if=/dev/zero of=nbsd_cats.img bs=1024 count=1 seek=2000000
+	dd if=/dev/zero of=nbsd_cats.img bs=1024 count=1 seek=3000000
    2. Download the NetBSD/cats 3.1 ISO image and the generic and install kernels:
      @@ -1023,10 +1028,11 @@
 
 
      NetBSD/prep:
      
 
-It is possible to install and run
-NetBSD/prep 2.1 in GXemul
-on an emulated IBM 6050 (PowerPC) machine. (NetBSD 3.0 uses the wdc 
-controller in a way which isn't implemented in GXemul yet.)
+It is possible to install and run NetBSD/prep 2.1 in GXemul on 
+an emulated IBM 6050 (PowerPC) machine. (Newer versions of NetBSD/prep use 
+the wdc controller in a way which isn't implemented in GXemul yet, or 
+there are bugs in GXemul's PowerPC CPU emulation.)
 
 
              
 
@@ -1047,7 +1053,7 @@

    3. Start the installation like this:
      -    gxemul -x -e ibm6050 -d nbsd_prep.img -d rdb:prepcd.iso -j prep/binary/kernel/netbsd-INSTALL.gz
+    gxemul -X -e ibm6050 -d nbsd_prep.img -d rdb:prepcd.iso -j prep/binary/kernel/netbsd-INSTALL.gz

      @@ -1100,7 +1106,7 @@

      If everything worked, NetBSD should now be installed on the disk image. Use the following command line to boot the emulated machine:

      -	gxemul -x -e ibm6050 -d nbsd_prep.img netbsd-GENERIC.gz
+	gxemul -X -e ibm6050 -d nbsd_prep.img netbsd-GENERIC.gz
      @@ -1119,37 +1125,78 @@ +


      + +

      NetBSD/macppc:

      +It is possible to install and run NetBSD/macppc in GXemul on +an emulated generic PowerPC machine. No specific Machintosh model is +emulated, but it is enough to for NetBSD to recognize it. -


      - -

      NetBSD/dreamcast:

      +

      To install NetBSD/macppc onto a disk image, follow these instructions: -SuperH emulation is very new in GXemul. This is -still highly experimental. +

      +

        +
      1. Create an empty harddisk image, which will be the root disk + that you will install NetBSD/macppc onto:
        +    dd if=/dev/zero of=nbsd_macppc.img bs=1024 count=1 seek=3000000
 
-
        It is possible to run NetBSD/dreamcast
-3.1 in GXemul. Only enough of the Dreamcast is emulated to let a NetBSD
-ramdisk kernel reach userland; no network interface is emulated yet, so 
-root-on-nfs is not possible.
+
        +
      2. Download the NetBSD/macppc 3.1 ISO image and a generic kernel:
        +    ftp://ftp.netbsd.org/pub/NetBSD/iso/3.1/macppccd-3.1.iso
+    ftp://ftp.netbsd.org/pub/NetBSD/NetBSD-3.1/macppc/binary/kernel/netbsd-GENERIC.MP.gz
 
-
                
-
+
        +

        +

      3. Start the installation like this:
        +    gxemul -x -e g4 -d nbsd_macppc.img -d b:macppccd-3.1.iso -j macppc/binary/kernel/netbsd-INSTALL.gz
 
-
        Download the 3.1 kernel and symbols here:
        -	ftp://ftp.netbsd.org/pub/NetBSD/NetBSD-3.1/dreamcast/binary/kernel/netbsd-GENERIC_MD.gz
-	ftp://ftp.netbsd.org/pub/NetBSD/NetBSD-3.1/dreamcast/binary/kernel/netbsd-GENERIC_MD.symbols.gz
 
        
+	and continue as you would do when installing NetBSD on a real
+	machine.
+  
        
+  
      4. Before turning the emulated machine off, quit the NetBSD installer
+	and execute the following commands:
        +	cd /; mount /dev/wd0a /mnt
+	echo 'console "/usr/libexec/getty std.38400" vt100 on secure' > /mnt/etc/ttys
+	echo 'rc_configured=YES' >> /mnt/etc/rc.conf
+	umount /mnt; sync
+	reboot
 
-
        Start NetBSD/dreamcast using the following command line:
        -	gxemul -XEdreamcast netbsd-GENERIC_MD.*
+
        
+
      + +

      If everything worked, NetBSD/macppc should now be installed on +the disk image. + +

      Use the following command line to boot the emulated machine:

      +	gxemul -x -e g4 -d nbsd_macppc.img netbsd-GENERIC.MP.gz
      +

      If asked about root device, enter wd0. + + + + + + + + + +


      + +

      NetBSD/dreamcast:

      + +Moved here. + + + @@ -1234,6 +1281,8 @@
    4. At the # prompt, do the following:
       	fsck /dev/rz1a        (and mark the filesystem as clean)
 	mount /dev/rz1a /
+	mkdir /kern
+	mkdir /mnt2
 	mount -t kernfs kern kern
 	./install
 
@@ -1781,10 +1830,6 @@
 
 
      
 
        
-  
      1. Compile gxemul with cache emulation: (NOTE: --enable-caches)
        -	./configure --enable-caches; make
-
-
        
   
      2. Download the pmax binary distribution for Mach 3.0:
         	http://lost-contact.mit.edu/afs/athena/user/d/a/
 	    daveg/Info/Links/Mach/src/release/pmax.tar.Z
@@ -1813,13 +1858,24 @@
 	cd /; sync; umount /mnt)
 	
        
   
      3. Start the emulator with the following command:
        -	gxemul -e 3max -X -d disk.img \
+	gxemul -c 'put w 0x800990e0, 0' -c 'put w 0x80099144, 0' \
+	    -c 'put w 0x8004aae8, 0' -e 3max -X -d disk.img \
 	    pmax_mach/special/mach.boot.MK83.STD+ANY
 
 
        
 
      
 
+
      Earlier versions of GXemul had a configure option to enable better 
+R3000 cache emulation, but since Mach was more or less the only thing that 
+used it, I removed it. Today's version of GXemul can thus not boot 
+mach.boot.MK83.STD+ANY straight off, it has to be patched to skip the 
+cache detection.
 
+
      The -c commands above patch the kernel to get past the cache detection.
+Thanks to Artur Bujdoso for these values.
+
+
      TODO: Better instructions on how to create the old-style UFS disk 
+image.
 
 
 
@@ -2213,15 +2269,11 @@
 mimic the MIPS machine mode used in Fabrice Bellard's
 QEMU.
 
-
      Follow these steps to download and run the Linux/QEMU_MIPS test
-ramdisk kernel:
+
      Download mips-test-0.1.tar.gz
+from http://fabrice.bellard.free.fr/qemu/download.html,
+and extract its contents (tar zxvf mips-test-0.1.tar.gz).
 
-
        
-  
      1. Download mips-test-0.1.tar.gz
-	from http://fabrice.bellard.free.fr/qemu/download.html,
-	and extract its contents (tar zxvf mips-test-0.1.tar.gz).
-  
        
-  
      2. Test it in GXemul using the following command line:
        +
        Test it in GXemul using the following command line:
         	gxemul -E qemu_mips -o 'console=ttyS0 root=/dev/ram
 		rd_start=0x80800000 rd_size=10000000 init=/bin/sh'
 		0x80800000:mips-test/initrd mips-test/vmlinux-r1
@@ -2229,33 +2281,6 @@
 
        
 
      
 
-
      "QEMU is a FAST! processor emulator" according to http://fabrice.bellard.free.fr/qemu/qemu-doc.html.
-Sometimes QEMU is faster than GXemul, sometimes it is the other way
-around. A quick (and quite unfair) test on my laptop (1.8 GHz Turion ML32,
-in AMD64 mode) comparing QEMU 0.8.2 (installed from FreeBSD ports)
-with GXemul gave the following result:
-
-
      -        while true; do ls -l > /dev/null; echo -n .; done
-        (80 x 36 dots)
-        QEMU 0.8.2:       13 min 52 sec
-	GXemul 0.4.2:      4 min 31 sec
-
-	while true; do /usr/bin/md5sum /usr/bin/* > /dev/null; echo -n .; done
-        (80 dots)
-        QEMU 0.8.2:        2 min  8 sec
-	GXemul 0.4.2:      5 min 18 sec
-
-        while true; do grep hej lib/libtextwrap.so.1 > /dev/null; echo -n .; done
-        (80 dots)
-        QEMU 0.8.2:        9 min 57 sec
-	GXemul 0.4.2:      1 min 36 sec
-
      
-
-
      The commands were run inside the emulators, using the ramdisk kernel
-mentioned above.
-
 
 
 
@@ -2306,58 +2331,6 @@
 
 
 
-
-
-
-
-
-

      
-
-
      NetBSD/macppc:
      
-
-It is ALMOST possible to install and run
-NetBSD/macppc in GXemul
-on an emulated generic PowerPC machine. No specific Machintosh model
-is emulated, but it is enough to for NetBSD to recognize it.
-
-
      To install NetBSD/macppc onto a disk image, follow these instructions:
-
-
      
-
        
-  
      1. Create an empty harddisk image, which will be the root disk
-	that you will install NetBSD/macppc onto:
        -    dd if=/dev/zero of=nbsd_macppc.img bs=1024 count=1 seek=2000000
-
-
        
-  
      2. Download the NetBSD/macppc 3.0 ISO image and a generic kernel:
        -    ftp://ftp.netbsd.org/pub/NetBSD/iso/3.0/macppccd-3.0.iso
-    ftp://ftp.netbsd.org/pub/NetBSD/NetBSD-3.0/macppc/binary/kernel/netbsd-GENERIC.MP.gz
-
-
        
-  
        
-  
      3. Start the installation like this:
        -    gxemul -x -e g4 -d nbsd_macppc.img -d b:macppccd-3.0.iso -j macppc/binary/kernel/netbsd-INSTALL.gz
-
-
        
-
      
-
-
      If everything worked, NetBSD/macppc should now be installed on the disk image.
-
-
      2006-02-26: That's it. The installation
-succeeds, but it is not possible to start from the newly installed disk.
-/sbin/init dies, so the following command doesn't really work yet:
-
-
      Use the following command line to boot the emulated machine:
      -	gxemul -x -e g4 -d nbsd_macppc.img netbsd-GENERIC.MP.gz
-
-
      
-
-
-
-
-
-
-