Changelog:
[20140817] Release 0.6.0.1. It has been a while since the last
release, and the SVN repository mirror at Sourceforge seems to be
broken, so it felt reasonable to package the current code into a
patch release. Not much has happened feature-wise since 0.6.0.
[20140816] On FreeBSD/amd64 with GCC 4.2.1 as the default compiler,
you may need to install GCC 4.8.4 and run the configure script like
this to avoid triggering a bug in the default compiler:
CXX=c++48 CXXFLAGS=-Wl,-rpath,/usr/local/lib/gcc48 ./configure
[20110820] Not much coding lately. The only thing worth mentioning
is that the Dreamcast emulation mode now gets further when running
Marcus Comstedt's test programs, and also shows "something" when
booting the PROM from my real Dreamcast. (This was in the legacy
Dreamcast mode, for fun. I haven't had time to work on the new
framework at all.)
[20100729] Uploaded a clip to YouTube, showing the NetBSD/pmax
install procedure in GXemul.
---
The main change between release 0.4.7.2 and 0.6.0 is:
* Since late 2007, a complete rewrite of the emulator's base framework
has been going on. GXemul 0.6.0 is a very early release of the new
framework. So far, only the testm88k machine mode has been rewritten
to use the new framework, all other machine modes run in legacy mode
using the old framework (which is still included).
In other words: For most emulation modes, 0.6.0 will be exactly
like 0.4.7.2.
In addition to the new framework, a couple of other changes are
worth mentioning:
* Many unused, rarely used, and bogus emulation modes and features
were removed, to reduce the maintenance burden.
* Some operating systems listed on the guest OS page have had
new releases; the documentation has been updated to reflect this.
* New source code (but not the legacy part) is documented using
Doxygen comments, and there is a unit testing framework in place.
* There is now finally an install Makefile target, and the -j make
option can be used to parallelize builds.
Please read the HISTORY file for more details.
---
Also update pkgsrc files:
* update COMMENT and DESCR per the latest release note
* remove MAKE_JOBS_SAFE=no as mentioned in the above changes list.
for running several NetBSD ports properly on the emulator. PR pkg/41742
Discussed with and okay'ed by wiz@.
Upstream changes:
The changes between release 0.4.6.6 and 0.4.7 are:
* Motorola 88K emulation is now complete enough to run a guest operating
system: OpenBSD/mvme88k 4.4.
A big thank you goes to Miod Vallat, who sent me physical 88100
documentation, via snail mail. This has been invaluable when implementing
the 88K emulation mode.
The changes between release 0.4.7 and 0.4.7.1 are:
* Applying a man page hypenation patch from Jonathan Wiltshire.
* Minor documentation errors fixed.
* Some more missing M88K instructions added.
* NetBSD/hpcmips can now be installed and run using serial console (i.e.
without -X), in addition to using the framebuffer.
The changes between release 0.4.7.1 and 0.4.7.2 are:
* NetBSD 5.0, OpenBSD 4.5, and HelenOS 0.4.0 have been released, and the
guest OS page has been updated to reflect this. (Not all versions and
architectures work; the versions listed on the guest OS page are the latest
ones that have been tested.)
* A bug has been fixed which prevented configuration files from being used.
Patches pulled from upstream trunk:
patch-aa:
Applying a patch for setting the ARCBIOS OSLOADPARTITION environment
variable in a more correct way.
http://gxemul.svn.sourceforge.net/viewvc/gxemul?view=rev&revision=5473
This makes NetBSD/arc work on PICA emulation with VGA console.
(more proper fix than the previous patch-aa)
patch-ab:
Better fix for the Cobalt board ID number.
http://gxemul.svn.sourceforge.net/viewvc/gxemul?view=rev&revision=5485
(fixes in the previous patch-ab has been integrated in the latest release)
patch-ac:
Applying a patch which makes NetBSD/hpcmips work well with the clock again.
http://gxemul.svn.sourceforge.net/viewvc/gxemul?view=rev&revision=5472
pkgsrc changes:
- update MASTER_SITES and HOMEPAGE (now they are in sourceforge)
- update PLIST (add share/doc/gxemul/unsupported.html)
Changes:
- Applying a patch from Kiyotaka Inaba which causes an ARM UND
exception to be generated by the instruction word 0xe6000011, which
is needed by gdb when running inside the emulator. Also enabling
ARM UND exceptions for ARM floating point instructions (needed by
both Linux and NetBSD/arm).
- Fix for a free() bug in bootblock_iso9660.c. Updating the
OpenBSD/landisk installation instructions from 4.2 to 4.4, after
verifying that it works.
The changes between release 0.4.6 and 0.4.6.1 are mostly focused on documentation
updates, to reflect new releases of guest operating systems:
* OpenBSD 4.2 has been released. OpenBSD/landisk 4.2 works in GXemul.
* NetBSD 4.0 has been released. The installation instructions in GXemul's
documentation have been updated to reflect this.
o In most cases this simply means that NetBSD 4.0 should work,
in addition to NetBSD 3.1.
Some specifics worth mentioning are:
o For NetBSD/pmax, the change from 3.1 to 4.0 means that X Windows is now
working again out-of-the-box. (Simply run startx as root to start X.)
o For NetBSD/arc, the supported version has jumped from 1.6.2 to 4.0.
o NetBSD/landisk has been released, and works in GXemul.
o NetBSD/prep is unfortunately still at NetBSD 2.1.
o In some emulation modes, such as evbmips, hpcmips, and perhaps some more,
NetBSD 4.0 uses the clock in a way which is not yet implemented in the
emulator. (NetBSD 4.0 works, but NetBSD 3.1 worked better.)
o (I have not tried some of the "heavier" emulation setups, such as
NetBSD/sgimips.)
The changes between release 0.4.5.1 and 0.4.6 include, among other things:
o) NetBSD/pmppc can now run in the emulator (with root-on-nfs), on
an emulated Artesyn PM/PPC board.
o) An instruction combination has been implemented for the idle loop
used by NetBSD/arm (cats, netwinder, and iq80321). In plain English,
this means that if the guest OS inside the emulator is not using
any CPU, the emulator should not use much CPU on the host either.
o) Some minor SuperH emulation speed improvements.
o) General code cleanup: Non-working (skeleton) emulation modes have
been removed, to make it easier to maintain the source code in
the long run, and many unused/legacy constructs have been removed.
The changes between release 0.4.5 and 0.4.5.1 include, among other things:
o) OpenBSD/landisk has now had its first release (4.1, 2007-05-01).
Landisk emulation is now stable enough to allow OpenBSD/landisk
to be installed onto a disk image, and run from it.
o) Finally found and fixed an old bug in the address to symbol name
lookup mechanism, which caused some symbols to be missed. Debug
output with -t or -i should now show all symbols.
o) Initial support for "disk overlays" has been implemented. This
enables e.g. simple roll-back of emulated disk contents to a
previous state.
o) Dyntrans bug fixes; code translations on physical addresses that
were offset a multiple of 128 MB from each other could either
cause weird bugs, or translation leaks (leading to unnecessary
dyntrans cache overflows).
o) Some cleanup: The GDB debugging stub support, some dummy machine
modes (TS7200, Walnut, PB1000, and Meshcube), and some dummy or
experimental CPUs (RCA180x and Transputer) have been removed, to
make the emulator slightly more maintainable.
o) SuperH (SH4) emulation is now somewhat more stable.
x) GXemul 0.4.4: A NetBSD/dreamcast Live CD works.
x) GXemul 0.4.4.1: A Linux/dreamcast Live CD also works.
o) PowerPC "G4" emulation is now stable enough to let NetBSD/macppc
run from a disk image. (Installing actually worked before, but the
NetBSD/macppc GENERIC kernel uses AltiVec instructions which were
not implemented correctly.)
o) The PICA-61 (arc) and i80321 (evbarm) emulation modes now have their
timers fixed at 100 Hz. A hardcoded speed like this is very ugly, but
it is at least better than before (when the timer wasn't really
running at any specific speed at all).
Changes between release 0.4.3 and 0.4.4 include, among other things:
o) The interrupt subsystem has been redesigned. This means two things:
x) Internal code cleanup, which makes the whole emulator more
maintainable. Instead of using magically encoded integers
for interrupts, strings are now used. These strings are in
the form of "paths", so that devices and busses can more
easily be connected to other busses, devices, or CPUs.
x) Some machine types which happened to work in release 0.4.3,
but were not listed in the documentation as working, may
have stopped working now. As always, the documentation should
indicate the combinations of machine modes and guest OSes that
are supposed to work.
o) SuperH (SH4) emulation is now somewhat more stable, enough to let a
NetBSD/dreamcast Live CD be usable.
o) PowerPC "G4" emulation is now stable enough to let NetBSD/macppc
run from a disk image. (Installing actually worked before, but the
NetBSD/macppc GENERIC kernel uses AltiVec instructions which were
not implemented correctly.)
o) The PICA-61 (arc) and i80321 (evbarm) emulation modes now have their
timers fixed at 100 Hz. A hardcoded speed like this is very ugly, but
it is at least better than before (when the timer wasn't really
running at any specific speed at all).
Changes between release 0.4.2 and 0.4.3 include, among other things:
o) SuperH (SH4) emulation is now stable enough to let a NetBSD/dreamcast
GENERIC_MD (ramdisk) kernel reach userland.
o) There is now a simple framework for letting emulated clocks, as seen
by guest operating systems, run at the same speed as the host clock.
So far, the DECstation, MobilePro (hpcmips), NetWinder, CATS, Malta
(evbmips), Cobalt, Algor, Dreamcast, and testmips machine modes
use the new clock/timer framework.
o) Some changes to the way expressions are evaluated in the built-in
debugger, and some changes in command behaviour:
x) Expressions (including assignments) can now be arbitrarily
complex, using parentheses, and the following operators:
+ - * / % (modulo) ^ (xor) & (and) | (or)
x) Some internal emulator variables can now be read/written using
normal expressions. Examples of commands that did not work
earlier, but should work now:
print verbose
r5 = sp - arch_pagesize * 4
machine[0].statistics_enabled = 1
x) To force a name to be interpreted as a setting/register name,
a hash sign (#) is now used instead of the percentage sign (%).
(In the new expression evaluator, % means arithmetic modulo.)
x) The 'focus' command now also selects a cpu, in addition to
selecting machine and emul.
x) The 'reg' command only prints registers for one cpu now, not
all cpus in the currently focused machine.
o) The wdc (standard IDE controller) had a bug which prevented disk
images larger than 2 GB to work correctly. This has been fixed.
o) For MIPS emulation, some combinations of emulated processor + guest
operating system should now work better when idling (i.e. the host
should not run at 100% CPU):
x) For MIPS32/MIPS64 and RM5200, the 'wait' instruction should
now work more or less as expected.
x) For VR41xx (e.g. MobilePro) emulation, the standby instruction
should work like the 'wait' instruction.
x) For R3000 emulation, where there is no hardware wait instruction,
I've implemented "instruction combination" hacks for both
NetBSD/pmax and Debian/pmax, so that their cpu idle loops are
detected and treated almost as a wait instruction.
o) MIPS 64-bit address translation (X=1) was not fully working before;
TLB exception handling for xkseg and larger-than-2GB-userland should
now actually work. (Thanks to Juli Mallett and Carl van Schaik for
noticing these problems.)
o) The mouse cursor update routines in DECstation (LK201) emulation
previously used the fact that guest OSes set the _hardware_
cursor position. In order to support X Windows when emulating
modern versions of NetBSD/pmax, which don't set the hardware
position anymore, a workaround has been implemented which only
sends relative coordinates to the guest OS. This has two drawbacks:
1. Ultrix emulation with dual- and tripple-head emulation will
most likely feel very strange. It will still work, though.
2. Cursor movement feels "accelerated", because the emulator
sends unaccelerated movements to the guest OS, which then
accelerates them. This can however be compensated to some
degree by running 'xset m 1 0' in the guest OS.
Having weird accelerated mouse movement is better than having no
mouse support at all, so this change was necessary.
Changes between release 0.4.1 and 0.4.2 include, among other things:
o) The NetWinder emulation mode now works well enough to let
NetBSD/netwinder run from a disk image.
(NetBSD/netwinder has to be installed manually, though, because
there is no installation ramdisk kernel. The GXemul documentation
has an example of how to install NetBSD/netwinder using an emulated
NetBSD/pmax machine.)
o) Algorithmics P5064 emulation works well enough to let NetBSD/algor
run from a disk image. (Similar to NetBSD/netwinder, it has to
be installed manually, using another emulated machine.)
o) PCI configuration register writes can now be handled, which allows
NetBSD/Malta (evbmips) 3.0.1 and NetBSD/cobalt 3.0.1 to run from
PCI IDE harddisk images. (Previously, only NetBSD 2.1 worked for
the Malta and Cobalt emulation modes.)
o) Some performance increases:
The virtual translation table update routine has been simplified
to work the same way for 32-bit and 64-bit emulation, and this
apparently results in a speedup for all 64-bit modes.
For 32-bit MIPS, some more instruction combinations have been added.
The most important change between release 0.3.8 and 0.4.0.1 is:
o) The emulation of MIPS processors has been completely rewritten;
it now uses the same portable dynamic translation system as the
ARM and PowerPC emulation modes.
On Alpha and i386 hosts (and AMD64 hosts running in 32-bit mode),
GXemul previously used translation into native code. This release
will perform worse than 0.3.8 on those host architectures.
On all other hosts (including AMD64 running in native 64-bit mode),
0.4.0 is likely to be faster than 0.3.8, when emulating MIPS.
I think that in the long term, moving towards full portability like
this is a good idea.
(0.4.0 was a bit buggy and unstable; 0.4.0.1 is a quick-fix release.)
There have also been many other changes, including, but not limited to:
o) The "test machine" functionality is more well-defined than before,
and some tutorial-like demos have been added. These could be useful
e.g. in operating system construction courses.
o) NetBSD/sgimips 3.0 works now. This is most likely due to the rewrite
of the MIPS emulation mode. Previous releases of GXemul only worked
with NetBSD/sgimips 2.1.
o) I have begun implementing rudimentary support for GDB remote serial
protocol connections. This means that you can run e.g. the Data
Display Debugger, and connect it to a GXemul instance.
No advanced GDB functionality is working yet, but starting and
stopping the emulated machine and single-stepping should work.
The user-visible changes between release 0.3.7 and 0.3.8 include:
o) The IQ80321 (Xscale) machine mode is now working well enough to
run NetBSD/evbarm 2.1.
o) Faster framebuffer output in some situations.
User-visible change between release 0.3.6.2 and 0.3.7 include:
o) The experimental PowerPC emulation mode is now working well enough
to allow NetBSD/prep 2.1 to be installed and run inside the emulator.
It is not 100% stable, and it is not optimized for performance yet,
but hopefully enough for simple experiments.
o) I finally took the time to implement a DEC 21143 NIC; this brings
network connectivity to NetBSD/cats. (The userland "NAT"-like
networking layer is still a bit buggy, and does not work with
everything. However, NetBSD/cats can now be installed via ftp.)
o) CD-ROM images can now in some cases be detected as ATAPI CD-ROMs
instead of IDE harddisks. It works for at least NetBSD, OpenBSD,
and Linux on CATS, and NetBSD on hpcmips.
Internal (code related) changes include:
o) Cleanup of the PCI and ISA bus frameworks; in practice this means
that more code can be shared between different emulated machine
models than before, and that adding new machine types will become
easier.
o) Dyntrans updates; 32-bit PowerPC mostly, but also many performance
related updates for ARM.
The most imporant user-visible change between release 0.3.5 and 0.3.6 is:
(X) The experimental ARM emulation mode is now working well enough
to install NetBSD/cats and OpenBSD/cats onto harddisk images.
Changes:
x) When emulating a network of multiple machines, the emulated
machines can now be placed on different hosts.
x) NetBSD/evbmips can now be installed and run from a disk image.
(There is no INSTALL kernel for NetBSD/evbmips, so you need to
install using another OS, for example emulated NetBSD/pmax.)
x) NetBSD/sgimips can now be installed. Not onto a SCSI disk,
but the files can be exported via nfs from another emulated
machine. The sgimips machine can then netboot. (Read the
documentation for details.)
The most important/visible changes from 0.3.1 to 0.3.2 are:
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.
The two most visible changes from version 0.3 to 0.3.1 are:
x) Name change (from mips64emul to GXemul).
x) NetBSD/hpcmips can now be installed and run from a harddisk
image on an emulated NEC MobilePro 770, 780, 800, or 880.
GXemul is a machine emulator. The initial goal was to write a simple
64-bit MIPS emulator for running multiprocessor experiments with a
microkernel, but the emulator can be used for many other things. While
some simulators only simulate a CPU, GXemul also simulates other
hardware components, making it possible to use the emulator to run
unmodified operating systems, such as NetBSD, OpenBSD, or Linux.
[previously known as mips64emul, it was renamed because now
supports more cpu archs than MIPS, as sparc, ppc...]
