--- trunk/RELEASE 2007/10/08 16:18:00 4 +++ trunk/RELEASE 2007/10/08 16:18:38 12 @@ -1,21 +1,25 @@ -Release notes for GXemul 0.3.2 -============================== +Release notes for Gavare's eXperimental Emulator (GXemul), 0.3.5 +================================================================ Copyright (C) 2003-2005 Anders Gavare. -GXemul is an experimental instruction-level machine emulator. It can be -used to run binary code for (among others) MIPS-based machines. Several -emulation modes are available. For some emulation modes, processors and -surrounding hardware components are emulated well enough to let unmodified -operating systems run as if they were running on a real machine. +GXemul is an experimental instruction-level machine emulator. It can be used to +run binary code for MIPS-based machines, regardless of host platform. Several +emulation modes are available. For some modes, processors and surrounding +hardware components are emulated well enough to let unmodified operating +systems (e.g. NetBSD) run as if they were running on a real machine. + +(Non-MIPS emulation modes are also under development, but so far none of those +modes has reached the completeness required to run unmodified operating +systems.) -I have verified that the following "guest" operating systems can run -inside the emulator: +I have verified that the following "guest" operating systems can run inside +the emulator: Guest operating system Emulated machine ---------------------- ---------------- - NetBSD/pmax 2.0 (and 1.6.2) DECstation 5000/200 + NetBSD/pmax 2.0.2 (and 1.6.2) DECstation 5000/200 OpenBSD/pmax 2.8-BETA DECstation 5000/200 Ultrix 4.2-4.5 DECstation 5000/200 Sprite demo harddisk image DECstation 5000/200 @@ -23,26 +27,38 @@ Redhat Linux 7.1 for mips DECstation 5000/200 NetBSD/arc 1.6.2 Acer PICA-61 OpenBSD/arc 2.3 Acer PICA-61 - NetBSD/hpcmips 2.0 NEC MobilePro 770, 780, 800, 880 - NetBSD/cobalt 2.0 Cobalt + NetBSD/hpcmips 2.0.2 NEC MobilePro 770, 780, 800, 880 + NetBSD/cobalt 2.0.2 Cobalt + NetBSD/evbmips 2.0.2 Malta 5Kc/4Kc evaluation board + NetBSD/sgimips 2.0.2 SGI O2 ("IP32") + +Some of these guest operating systems are easier to install and run than +others. The best supported mode is the DECstation 5000/200 emulation mode, with +NetBSD/pmax as the guest operating system. + +A couple of other emulation modes exist. Some of these modes are almost working +well enough to run complete guest operating systems, but most are just +skeletons. The modes that work are listed in the documentation. + +The emulator can also be used in other experiments; it does not have to run +entire guest operating systems. (However, GXemul does not simulate things +smaller than an instruction. What this means is that pipe-line stalls, +penalties caused by branch-prediction misses or cache misses, and other +micro-architectural effects are not simulated.) + +The user-visible changes between release 0.3.4 and 0.3.5 are minor, and +can be summarized as follows: + + o) Updates to the (old) binary translation subsystem, resulting + in minor speed improvements. -A couple of other emulation modes exist. Some of these modes are almost -working well enough to run complete guest operating systems, but most are -just skeletons. The modes that work are listed in the documentation. - -The emulator can also be used in other experiments; it does not have to -run entire guest operating systems. It is important to remember, though, -that GXemul does not simulate things smaller than an instruction; this -means that pipe-line stalls, penalties caused by branch-prediction misses, -and other effects are not simulated. + o) 64-bit MIPS dmult/dmultu has been fixed. -The most important/visible changes from 0.3.1 to 0.3.2 are: + o) slt* instructions for 64-bit MIPS were incorrectly implemented + in the i386 backend. This has been fixed. - x) NetBSD/cobalt can run from a harddisk image. (Installation - must be done using another OS though, for example NetBSD/pmax.) - - x) Some minor fixes to make the binary translation system a bit - more stable. +There have been many other bug fixes and updates, most of which are not +visible. Files included in this release are: @@ -56,7 +72,6 @@ doc Documentation. experiments Experimental code. (Usually not needed.) src Source code. - tests Regression tests. To build the emulator, run the ./configure script, and then run make. @@ -128,10 +143,26 @@ This product includes software developed by Marc Horowitz. +Also, src/include/alpha_rpb.h requires the following: + + Copyright (c) 1994, 1995, 1996 Carnegie-Mellon University. + All rights reserved. + + Author: Keith Bostic, Chris G. Demetriou + + Permission to use, copy, modify and distribute this software and + its documentation is hereby granted, provided that both the copyright + notice and this permission notice appear in all copies of the + software, derivative works or modified versions, and any portions + thereof, and that both notices appear in supporting documentation. + + See individual files for license details, if you plan to redistribute GXemul or reuse code. -Thanks to everyone who has provided me with feedback. +Thanks to (in no specific order) Joachim Buss, Juli Mallett, Juan RP, Alec +Voropay, Göran Weinholt, Alexander Yurchenko, and everyone else who has +provided me with feedback. If you have found GXemul useful in some way, or feel like sending me comments or feedback in general, then mail me at anders(at)gavare.se.