# Release notes for GXemul 0.6.0.2

Copyright (C) 2003-2018 Anders Gavare

GXemul is a framework for full-system computer architecture emulation. Several processor architectures and machine types have been implemented. It is working well enough to allow unmodified "guest" operating systems to run inside the emulator, as if they were running on real hardware.

The emulator emulates (networks of) real machines. The machines may consist of ARM, MIPS, Motorola 88K, PowerPC, and SuperH processors, and various surrounding hardware components such as framebuffers, busses, interrupt controllers, ethernet controllers, disk controllers, and serial port controllers.

The documentation lists the machines and guest operating systems that can be regarded as "working" in GXemul. The first guest operating system that worked in GXemul is NetBSD/pmax, and that is still one of the guest OSes that works best.

The changes between release 0.6.0.2 and 0.6.0.1 are relatively minor. They include:

General:

- Minor fixes to make it possible to build GXemul using relatively modern compilers (GCC 6.4.0 and clang 3.4.1).
- Updating the guest OS installation instructions with newer versions of guest OSes.

Old framework:

- MIPS:
  - Bug fix for the case when a guest OS used larger-than-4KB pages, when it comes to invalidating previous translations. This makes e.g. recent versions of HelenOS on Malta run further than before.

New framework:

- Intel i960:
  - Disassembly of i960CA instructions has been implemented. Execution is not implemented yet, but disassembly support may still be useful when debugging or inspecting i960 binaries.
  - Intel b.out file format loader.

Please read the HISTORY file for more details.

To build the emulator, run the `configure` script, and then run `make`. This should hopefully work on most Unix-like systems, with few or no modifications to the source code.

Regarding files in the `src/include/` directory: only some of these are written by me, the rest are from other sources (such as NetBSD). See individual source files for details, if you plan to redistribute GXemul or reuse code.

GXemul's homepage is http://gavare.se/gxemul/.