/[gxemul]/upstream/0.4.3/RELEASE
This is repository of my old source code which isn't updated any more. Go to git.rot13.org for current projects!
ViewVC logotype

Diff of /upstream/0.4.3/RELEASE

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

trunk/RELEASE revision 10 by dpavlin, Mon Oct 8 16:18:27 2007 UTC upstream/0.4.3/RELEASE revision 33 by dpavlin, Mon Oct 8 16:21:06 2007 UTC
# Line 1  Line 1 
1  Release notes for GXemul 0.3.4  Release notes for Gavare's eXperimental Emulator (GXemul), 0.4.3
2  ==============================  ================================================================
3    
4  Copyright (C) 2003-2005  Anders Gavare.  Copyright (C) 2003-2006  Anders Gavare.
5    
6    
7  GXemul is an experimental instruction-level machine emulator. It can be  GXemul is an experimental instruction-level machine emulator. Several
8  used to run binary code for (among others) MIPS-based machines, regardless  emulation modes are available. In some modes, processors and surrounding
9  of host platform. Several emulation modes are available. For some modes,  hardware components are emulated well enough to let unmodified operating
10  processors and surrounding hardware components are emulated well enough to  systems (e.g. NetBSD) run as if they were running on a real machine.
11  let unmodified operating systems (e.g. NetBSD) run as if they were running  
12  on a real machine.  The documentation lists the machines and guest operating systems that can
13    be regarded as "working" in GXemul. The best working guest operating
14  I have verified that the following "guest" operating systems can run  systems are probably NetBSD/pmax, NetBSD/cats, and OpenBSD/cats.
15  inside the emulator:  
16    
17      Guest operating system             Emulated machine  Changes between release 0.4.2 and 0.4.3 include, among other things:
18      ----------------------             ----------------  
19      NetBSD/pmax 2.0.2 (and 1.6.2)      DECstation 5000/200      o)  SuperH (SH4) emulation is now stable enough to let a NetBSD/dreamcast
20      OpenBSD/pmax 2.8-BETA              DECstation 5000/200          GENERIC_MD (ramdisk) kernel reach userland.
21      Ultrix 4.2-4.5                     DECstation 5000/200  
22      Sprite demo harddisk image         DECstation 5000/200      o)  There is now a simple framework for letting emulated clocks, as seen
23      Debian GNU/Linux for DECstation    DECstation 5000/200          by guest operating systems, run at the same speed as the host clock.
24      Redhat Linux 7.1 for mips          DECstation 5000/200  
25      NetBSD/arc 1.6.2                   Acer PICA-61          So far, the DECstation, MobilePro (hpcmips), NetWinder, CATS, Malta
26      OpenBSD/arc 2.3                    Acer PICA-61          (evbmips), Cobalt, Algor, Dreamcast, and testmips machine modes
27      NetBSD/hpcmips 2.0.2               NEC MobilePro 770, 780, 800, 880          use the new clock/timer framework.
28      NetBSD/cobalt 2.0.2                Cobalt  
29      NetBSD/evbmips 2.0.2               Malta 5Kc/4Kc evaluation board      o)  Some changes to the way expressions are evaluated in the built-in
30      NetBSD/sgimips 2.0.2               SGI O2 ("IP32")          debugger, and some changes in command behaviour:
31    
32  Some of these guest operating systems are easier to install and run than            x)  Expressions (including assignments) can now be arbitrarily
33  others. The best supported mode is the DECstation 5000/200 emulation mode,                complex, using parentheses, and the following operators:
34  with NetBSD/pmax as the guest operating system.  
35                      + - * /    % (modulo)  ^ (xor)  & (and)  | (or)
36  A couple of other emulation modes exist. Some of these modes are almost  
37  working well enough to run complete guest operating systems, but most are            x)  Some internal emulator variables can now be read/written using
38  just skeletons. The modes that work are listed in the documentation.                normal expressions. Examples of commands that did not work
39                  earlier, but should work now:
40  The emulator can also be used in other experiments; it does not have to  
41  run entire guest operating systems. (However, GXemul does not simulate                    print verbose
42  things smaller than an instruction. What this means is that pipe-line                    r5 = sp - arch_pagesize * 4
43  stalls, penalties caused by branch-prediction misses or cache misses, and                    machine[0].statistics_enabled = 1
44  other micro-architectural effects are not simulated.)  
45              x)  To force a name to be interpreted as a setting/register name,
46  Summary of changes between release 0.3.3.2 and 0.3.4:                a hash sign (#) is now used instead of the percentage sign (%).
47                  (In the new expression evaluator, % means arithmetic modulo.)
48          x)  When emulating a network of multiple machines, the emulated  
49              machines can now be placed on different hosts.            x)  The 'focus' command now also selects a cpu, in addition to
50                  selecting machine and emul.
51          x)  NetBSD/evbmips can now be installed and run from a disk image.  
52              (There is no INSTALL kernel for NetBSD/evbmips, so you need to            x)  The 'reg' command only prints registers for one cpu now, not
53              install using another OS, for example emulated NetBSD/pmax.)                all cpus in the currently focused machine.
54    
55          x)  NetBSD/sgimips can now be installed. Not onto a SCSI disk,      o)  The wdc (standard IDE controller) had a bug which prevented disk
56              but the files can be exported via nfs from another emulated          images larger than 2 GB to work correctly. This has been fixed.
57              machine. The sgimips machine can then netboot. (Read the  
58              documentation for details.)      o)  For MIPS emulation, some combinations of emulated processor + guest
59            operating system should now work better when idling (i.e. the host
60            should not run at 100% CPU):
61    
62              x)  For MIPS32/MIPS64 and RM5200, the 'wait' instruction should
63                  now work more or less as expected.
64    
65              x)  For VR41xx (e.g. MobilePro) emulation, the standby instruction
66                  should work like the 'wait' instruction.
67    
68              x)  For R3000 emulation, where there is no hardware wait instruction,
69                  I've implemented "instruction combination" hacks for both
70                  NetBSD/pmax and Debian/pmax, so that their cpu idle loops are
71                  detected and treated almost as a wait instruction.
72    
73        o)  MIPS 64-bit address translation (X=1) was not fully working before;
74            TLB exception handling for xkseg and larger-than-2GB-userland should
75            now actually work. (Thanks to Juli Mallett and Carl van Schaik for
76            noticing these problems.)
77    
78        o)  The mouse cursor update routines in DECstation (LK201) emulation
79            previously used the fact that guest OSes set the _hardware_
80            cursor position. In order to support X Windows when emulating
81            modern versions of NetBSD/pmax, which don't set the hardware
82            position anymore, a workaround has been implemented which only
83            sends relative coordinates to the guest OS. This has two drawbacks:
84    
85            1. Ultrix emulation with dual- and tripple-head emulation will
86               most likely feel very strange. It will still work, though.
87    
88            2. Cursor movement feels "accelerated", because the emulator
89               sends unaccelerated movements to the guest OS, which then
90               accelerates them. This can however be compensated to some
91               degree by running 'xset m 1 0' in the guest OS.
92    
93            Having weird accelerated mouse movement is better than having no
94            mouse support at all, so this change was necessary.
95    
96    Please read the HISTORY files for more details.
97    
 There have also been various other minor updates and bugfixes.  
98    
99  Files included in this release are:  Files included in this release are:
100    
   BUGS                        A list of known bugs.  
101    HISTORY                     Detailed revision history / changelog.    HISTORY                     Detailed revision history / changelog.
102    LICENSE                     Copyright message / license.    LICENSE                     Copyright message / license.
103    README                      Quick start instructions, for the impatient.    README                      Quick start instructions, for the impatient.
104    RELEASE                     This file.    RELEASE                     This file.
105    TODO                        TODO notes.    TODO                        TODO notes.
106    configure, Makefile.skel    sh and make scripts for building GXemul.    configure, Makefile.skel    sh and make scripts for building GXemul.
107      demos                       Tutorial-like demos of testmachine functionality.
108    doc                         Documentation.    doc                         Documentation.
109    experiments                 Experimental code. (Usually not needed.)    experiments                 Experimental code. (Usually not needed.)
110    src                         Source code.    src                         Source code.
   tests                       Regression tests.  
111    
112  To build the emulator, run the ./configure script, and then run make.  To build the emulator, run the configure script, and then run make. This
113    should work on most Unix-like systems.
114    
 Building the emulator should work on most Unix-like systems. (One system which  
 is specifically known to NOT work is Ultrix/RISC inside the emulator; Ultrix  
 chokes on the configure script and the default cc in Ultrix doesn't work.)  
115    
116  Regarding files in the src/include/ directory: only some of these are written  Regarding files in the src/include/ directory: only some of these are written
117  by me, the rest are from other sources (such as NetBSD). The license text says  by me, the rest are from other sources (such as NetBSD). The license text says
# Line 143  them like this is in order: Line 177  them like this is in order:
177    
178      This product includes software developed by Marc Horowitz.      This product includes software developed by Marc Horowitz.
179    
180        This product includes software developed by Brini.
181    
182        This product includes software developed by Mark Brinicombe
183        for the NetBSD Project.
184    
185        This product includes software developed by TooLs GmbH.
186    
187        This product includes software developed by Manuel Bouyer.
188    
189        This product includes software developed by the Alice Group.
190    
191        This product includes software developed by Ichiro FUKUHARA.
192    
193        This product includes software developed by Marcus Comstedt.
194    
195    Also, src/include/alpha_rpb.h requires the following:
196    
197        Copyright (c) 1994, 1995, 1996 Carnegie-Mellon University.
198        All rights reserved.
199    
200        Author: Keith Bostic, Chris G. Demetriou
201    
202        Permission to use, copy, modify and distribute this software and
203        its documentation is hereby granted, provided that both the copyright
204        notice and this permission notice appear in all copies of the
205        software, derivative works or modified versions, and any portions
206        thereof, and that both notices appear in supporting documentation.
207    
208  See individual files for license details, if you plan to redistribute GXemul  See individual files for license details, if you plan to redistribute GXemul
209  or reuse code.  or reuse code.
210    
 Thanks to (in no specific order, that is, this is in alphabetic order :-)  
 Joachim Buss, Juli Mallett, Juan RP, Alec Voropay, Alexander Yurchenko,  
 and everyone else who has provided me with feedback.  
211    
212  If you have found GXemul useful in some way, or feel like sending me comments  If you have found GXemul useful in some way, or feel like sending me comments
213  or feedback in general, then mail me at anders(at)gavare.se.  or feedback in general, then mail me at anders(at)gavare.se.

Legend:
Removed from v.10  
changed lines
  Added in v.33

  ViewVC Help
Powered by ViewVC 1.1.26