From: Paolo Bonzini <pbonzini@redhat.com>

Signed-off-by: Paolo Bonzini <pbonzini@redhat.com>
Message-id: 20200226113034.6741-9-pbonzini@redhat.com
Reviewed-by: Peter Maydell <peter.maydell@linaro.org>
Signed-off-by: Peter Maydell <peter.maydell@linaro.org>
---
 docs/system/target-arm.texi     | 264 ++++++++++
 docs/system/target-i386.texi    |  92 ++++
 docs/system/target-m68k.texi    |  46 ++
 docs/system/target-mips.texi    | 152 ++++++
 docs/system/target-ppc.texi     |  78 +++
 docs/system/target-sparc.texi   |  96 ++++
 docs/system/target-sparc64.texi |  61 +++
 docs/system/target-xtensa.texi  |  56 ++
 qemu-doc.texi                   | 873 +-------------------------------
 9 files changed, 853 insertions(+), 865 deletions(-)
 create mode 100644 docs/system/target-arm.texi
 create mode 100644 docs/system/target-i386.texi
 create mode 100644 docs/system/target-m68k.texi
 create mode 100644 docs/system/target-mips.texi
 create mode 100644 docs/system/target-ppc.texi
 create mode 100644 docs/system/target-sparc.texi
 create mode 100644 docs/system/target-sparc64.texi
 create mode 100644 docs/system/target-xtensa.texi

diff --git a/docs/system/target-arm.texi b/docs/system/target-arm.texi
new file mode 100644
index 00000000000..040d77b5e05
--- /dev/null
+++ b/docs/system/target-arm.texi
@@ -0,0 +1,264 @@
+@node ARM System emulator
+@section ARM System emulator
+@cindex system emulation (ARM)
+
+Use the executable @file{qemu-system-arm} to simulate a ARM
+machine. The ARM Integrator/CP board is emulated with the following
+devices:
+
+@itemize @minus
+@item
+ARM926E, ARM1026E, ARM946E, ARM1136 or Cortex-A8 CPU
+@item
+Two PL011 UARTs
+@item
+SMC 91c111 Ethernet adapter
+@item
+PL110 LCD controller
+@item
+PL050 KMI with PS/2 keyboard and mouse.
+@item
+PL181 MultiMedia Card Interface with SD card.
+@end itemize
+
+The ARM Versatile baseboard is emulated with the following devices:
+
+@itemize @minus
+@item
+ARM926E, ARM1136 or Cortex-A8 CPU
+@item
+PL190 Vectored Interrupt Controller
+@item
+Four PL011 UARTs
+@item
+SMC 91c111 Ethernet adapter
+@item
+PL110 LCD controller
+@item
+PL050 KMI with PS/2 keyboard and mouse.
+@item
+PCI host bridge.  Note the emulated PCI bridge only provides access to
+PCI memory space.  It does not provide access to PCI IO space.
+This means some devices (eg. ne2k_pci NIC) are not usable, and others
+(eg. rtl8139 NIC) are only usable when the guest drivers use the memory
+mapped control registers.
+@item
+PCI OHCI USB controller.
+@item
+LSI53C895A PCI SCSI Host Bus Adapter with hard disk and CD-ROM devices.
+@item
+PL181 MultiMedia Card Interface with SD card.
+@end itemize
+
+Several variants of the ARM RealView baseboard are emulated,
+including the EB, PB-A8 and PBX-A9.  Due to interactions with the
+bootloader, only certain Linux kernel configurations work out
+of the box on these boards.
+
+Kernels for the PB-A8 board should have CONFIG_REALVIEW_HIGH_PHYS_OFFSET
+enabled in the kernel, and expect 512M RAM.  Kernels for The PBX-A9 board
+should have CONFIG_SPARSEMEM enabled, CONFIG_REALVIEW_HIGH_PHYS_OFFSET
+disabled and expect 1024M RAM.
+
+The following devices are emulated:
+
+@itemize @minus
+@item
+ARM926E, ARM1136, ARM11MPCore, Cortex-A8 or Cortex-A9 MPCore CPU
+@item
+ARM AMBA Generic/Distributed Interrupt Controller
+@item
+Four PL011 UARTs
+@item
+SMC 91c111 or SMSC LAN9118 Ethernet adapter
+@item
+PL110 LCD controller
+@item
+PL050 KMI with PS/2 keyboard and mouse
+@item
+PCI host bridge
+@item
+PCI OHCI USB controller
+@item
+LSI53C895A PCI SCSI Host Bus Adapter with hard disk and CD-ROM devices
+@item
+PL181 MultiMedia Card Interface with SD card.
+@end itemize
+
+The XScale-based clamshell PDA models ("Spitz", "Akita", "Borzoi"
+and "Terrier") emulation includes the following peripherals:
+
+@itemize @minus
+@item
+Intel PXA270 System-on-chip (ARM V5TE core)
+@item
+NAND Flash memory
+@item
+IBM/Hitachi DSCM microdrive in a PXA PCMCIA slot - not in "Akita"
+@item
+On-chip OHCI USB controller
+@item
+On-chip LCD controller
+@item
+On-chip Real Time Clock
+@item
+TI ADS7846 touchscreen controller on SSP bus
+@item
+Maxim MAX1111 analog-digital converter on I@math{^2}C bus
+@item
+GPIO-connected keyboard controller and LEDs
+@item
+Secure Digital card connected to PXA MMC/SD host
+@item
+Three on-chip UARTs
+@item
+WM8750 audio CODEC on I@math{^2}C and I@math{^2}S busses
+@end itemize
+
+The Palm Tungsten|E PDA (codename "Cheetah") emulation includes the
+following elements:
+
+@itemize @minus
+@item
+Texas Instruments OMAP310 System-on-chip (ARM 925T core)
+@item
+ROM and RAM memories (ROM firmware image can be loaded with -option-rom)
+@item
+On-chip LCD controller
+@item
+On-chip Real Time Clock
+@item
+TI TSC2102i touchscreen controller / analog-digital converter / Audio
+CODEC, connected through MicroWire and I@math{^2}S busses
+@item
+GPIO-connected matrix keypad
+@item
+Secure Digital card connected to OMAP MMC/SD host
+@item
+Three on-chip UARTs
+@end itemize
+
+Nokia N800 and N810 internet tablets (known also as RX-34 and RX-44 / 48)
+emulation supports the following elements:
+
+@itemize @minus
+@item
+Texas Instruments OMAP2420 System-on-chip (ARM 1136 core)
+@item
+RAM and non-volatile OneNAND Flash memories
+@item
+Display connected to EPSON remote framebuffer chip and OMAP on-chip
+display controller and a LS041y3 MIPI DBI-C controller
+@item
+TI TSC2301 (in N800) and TI TSC2005 (in N810) touchscreen controllers
+driven through SPI bus
+@item
+National Semiconductor LM8323-controlled qwerty keyboard driven
+through I@math{^2}C bus
+@item
+Secure Digital card connected to OMAP MMC/SD host
+@item
+Three OMAP on-chip UARTs and on-chip STI debugging console
+@item
+Mentor Graphics "Inventra" dual-role USB controller embedded in a TI
+TUSB6010 chip - only USB host mode is supported
+@item
+TI TMP105 temperature sensor driven through I@math{^2}C bus
+@item
+TI TWL92230C power management companion with an RTC on I@math{^2}C bus
+@item
+Nokia RETU and TAHVO multi-purpose chips with an RTC, connected
+through CBUS
+@end itemize
+
+The Luminary Micro Stellaris LM3S811EVB emulation includes the following
+devices:
+
+@itemize @minus
+@item
+Cortex-M3 CPU core.
+@item
+64k Flash and 8k SRAM.
+@item
+Timers, UARTs, ADC and I@math{^2}C interface.
+@item
+OSRAM Pictiva 96x16 OLED with SSD0303 controller on I@math{^2}C bus.
+@end itemize
+
+The Luminary Micro Stellaris LM3S6965EVB emulation includes the following
+devices:
+
+@itemize @minus
+@item
+Cortex-M3 CPU core.
+@item
+256k Flash and 64k SRAM.
+@item
+Timers, UARTs, ADC, I@math{^2}C and SSI interfaces.
+@item
+OSRAM Pictiva 128x64 OLED with SSD0323 controller connected via SSI.
+@end itemize
+
+The Freecom MusicPal internet radio emulation includes the following
+elements:
+
+@itemize @minus
+@item
+Marvell MV88W8618 ARM core.
+@item
+32 MB RAM, 256 KB SRAM, 8 MB flash.
+@item
+Up to 2 16550 UARTs
+@item
+MV88W8xx8 Ethernet controller
+@item
+MV88W8618 audio controller, WM8750 CODEC and mixer
+@item
+128×64 display with brightness control
+@item
+2 buttons, 2 navigation wheels with button function
+@end itemize
+
+The Siemens SX1 models v1 and v2 (default) basic emulation.
+The emulation includes the following elements:
+
+@itemize @minus
+@item
+Texas Instruments OMAP310 System-on-chip (ARM 925T core)
+@item
+ROM and RAM memories (ROM firmware image can be loaded with -pflash)
+V1
+1 Flash of 16MB and 1 Flash of 8MB
+V2
+1 Flash of 32MB
+@item
+On-chip LCD controller
+@item
+On-chip Real Time Clock
+@item
+Secure Digital card connected to OMAP MMC/SD host
+@item
+Three on-chip UARTs
+@end itemize
+
+A Linux 2.6 test image is available on the QEMU web site. More
+information is available in the QEMU mailing-list archive.
+
+@c man begin OPTIONS
+
+The following options are specific to the ARM emulation:
+
+@table @option
+
+@item -semihosting
+Enable semihosting syscall emulation.
+
+On ARM this implements the "Angel" interface.
+
+Note that this allows guest direct access to the host filesystem,
+so should only be used with trusted guest OS.
+
+@end table
+
+@c man end
+
diff --git a/docs/system/target-i386.texi b/docs/system/target-i386.texi
new file mode 100644
index 00000000000..edd23fa8df5
--- /dev/null
+++ b/docs/system/target-i386.texi
@@ -0,0 +1,92 @@
+@node x86 (PC) System emulator
+@section x86 (PC) System emulator
+@cindex system emulation (PC)
+
+@menu
+* pcsys_devices::      Peripherals
+* cpu_models_x86::     CPU models
+* pcsys_req::          OS requirements
+@end menu
+
+@node pcsys_devices
+@subsection Peripherals
+
+@c man begin DESCRIPTION
+
+The QEMU PC System emulator simulates the following peripherals:
+
+@itemize @minus
+@item
+i440FX host PCI bridge and PIIX3 PCI to ISA bridge
+@item
+Cirrus CLGD 5446 PCI VGA card or dummy VGA card with Bochs VESA
+extensions (hardware level, including all non standard modes).
+@item
+PS/2 mouse and keyboard
+@item
+2 PCI IDE interfaces with hard disk and CD-ROM support
+@item
+Floppy disk
+@item
+PCI and ISA network adapters
+@item
+Serial ports
+@item
+IPMI BMC, either and internal or external one
+@item
+Creative SoundBlaster 16 sound card
+@item
+ENSONIQ AudioPCI ES1370 sound card
+@item
+Intel 82801AA AC97 Audio compatible sound card
+@item
+Intel HD Audio Controller and HDA codec
+@item
+Adlib (OPL2) - Yamaha YM3812 compatible chip
+@item
+Gravis Ultrasound GF1 sound card
+@item
+CS4231A compatible sound card
+@item
+PCI UHCI, OHCI, EHCI or XHCI USB controller and a virtual USB-1.1 hub.
+@end itemize
+
+SMP is supported with up to 255 CPUs.
+
+QEMU uses the PC BIOS from the Seabios project and the Plex86/Bochs LGPL
+VGA BIOS.
+
+QEMU uses YM3812 emulation by Tatsuyuki Satoh.
+
+QEMU uses GUS emulation (GUSEMU32 @url{http://www.deinmeister.de/gusemu/})
+by Tibor "TS" Schütz.
+
+Note that, by default, GUS shares IRQ(7) with parallel ports and so
+QEMU must be told to not have parallel ports to have working GUS.
+
+@example
+@value{qemu_system_x86} dos.img -soundhw gus -parallel none
+@end example
+
+Alternatively:
+@example
+@value{qemu_system_x86} dos.img -device gus,irq=5
+@end example
+
+Or some other unclaimed IRQ.
+
+CS4231A is the chip used in Windows Sound System and GUSMAX products
+
+@c man end
+
+@lowersections
+@include docs/system/cpu-models-x86.texi
+@raisesections
+
+@node pcsys_req
+@subsection OS requirements
+
+On x86_64 hosts, the default set of CPU features enabled by the KVM accelerator
+require the host to be running Linux v4.5 or newer.  Red Hat Enterprise Linux
+7 is also supported, since the required functionality was backported.
+
diff --git a/docs/system/target-m68k.texi b/docs/system/target-m68k.texi
new file mode 100644
index 00000000000..b5bc9df40ae
--- /dev/null
+++ b/docs/system/target-m68k.texi
@@ -0,0 +1,46 @@
+@node ColdFire System emulator
+@section ColdFire System emulator
+@cindex system emulation (ColdFire)
+@cindex system emulation (M68K)
+
+Use the executable @file{qemu-system-m68k} to simulate a ColdFire machine.
+The emulator is able to boot a uClinux kernel.
+
+The M5208EVB emulation includes the following devices:
+
+@itemize @minus
+@item
+MCF5208 ColdFire V2 Microprocessor (ISA A+ with EMAC).
+@item
+Three Two on-chip UARTs.
+@item
+Fast Ethernet Controller (FEC)
+@end itemize
+
+The AN5206 emulation includes the following devices:
+
+@itemize @minus
+@item
+MCF5206 ColdFire V2 Microprocessor.
+@item
+Two on-chip UARTs.
+@end itemize
+
+@c man begin OPTIONS
+
+The following options are specific to the ColdFire emulation:
+
+@table @option
+
+@item -semihosting
+Enable semihosting syscall emulation.
+
+On M68K this implements the "ColdFire GDB" interface used by libgloss.
+
+Note that this allows guest direct access to the host filesystem,
+so should only be used with trusted guest OS.
+
+@end table
+
+@c man end
+
diff --git a/docs/system/target-mips.texi b/docs/system/target-mips.texi
new file mode 100644
index 00000000000..f722c00912a
--- /dev/null
+++ b/docs/system/target-mips.texi
@@ -0,0 +1,152 @@
+@node MIPS System emulator
+@section MIPS System emulator
+@cindex system emulation (MIPS)
+
+@menu
+* recommendations_cpu_models_MIPS:: Supported CPU model configurations on MIPS hosts
+* nanoMIPS System emulator ::
+@end menu
+
+Four executables cover simulation of 32 and 64-bit MIPS systems in
+both endian options, @file{qemu-system-mips}, @file{qemu-system-mipsel}
+@file{qemu-system-mips64} and @file{qemu-system-mips64el}.
+Five different machine types are emulated:
+
+@itemize @minus
+@item
+A generic ISA PC-like machine "mips"
+@item
+The MIPS Malta prototype board "malta"
+@item
+An ACER Pica "pica61". This machine needs the 64-bit emulator.
+@item
+MIPS emulator pseudo board "mipssim"
+@item
+A MIPS Magnum R4000 machine "magnum". This machine needs the 64-bit emulator.
+@end itemize
+
+The generic emulation is supported by Debian 'Etch' and is able to
+install Debian into a virtual disk image. The following devices are
+emulated:
+
+@itemize @minus
+@item
+A range of MIPS CPUs, default is the 24Kf
+@item
+PC style serial port
+@item
+PC style IDE disk
+@item
+NE2000 network card
+@end itemize
+
+The Malta emulation supports the following devices:
+
+@itemize @minus
+@item
+Core board with MIPS 24Kf CPU and Galileo system controller
+@item
+PIIX4 PCI/USB/SMbus controller
+@item
+The Multi-I/O chip's serial device
+@item
+PCI network cards (PCnet32 and others)
+@item
+Malta FPGA serial device
+@item
+Cirrus (default) or any other PCI VGA graphics card
+@end itemize
+
+The Boston board emulation supports the following devices:
+
+@itemize @minus
+@item
+Xilinx FPGA, which includes a PCIe root port and an UART
+@item
+Intel EG20T PCH connects the I/O peripherals, but only the SATA bus is emulated
+@end itemize
+
+The ACER Pica emulation supports:
+
+@itemize @minus
+@item
+MIPS R4000 CPU
+@item
+PC-style IRQ and DMA controllers
+@item
+PC Keyboard
+@item
+IDE controller
+@end itemize
+
+The MIPS Magnum R4000 emulation supports:
+
+@itemize @minus
+@item
+MIPS R4000 CPU
+@item
+PC-style IRQ controller
+@item
+PC Keyboard
+@item
+SCSI controller
+@item
+G364 framebuffer
+@end itemize
+
+The Fulong 2E emulation supports:
+
+@itemize @minus
+@item
+Loongson 2E CPU
+@item
+Bonito64 system controller as North Bridge
+@item
+VT82C686 chipset as South Bridge
+@item
+RTL8139D as a network card chipset
+@end itemize
+
+The mipssim pseudo board emulation provides an environment similar
+to what the proprietary MIPS emulator uses for running Linux.
+It supports:
+
+@itemize @minus
+@item
+A range of MIPS CPUs, default is the 24Kf
+@item
+PC style serial port
+@item
+MIPSnet network emulation
+@end itemize
+
+@lowersections
+@include docs/system/cpu-models-mips.texi
+@raisesections
+
+@node nanoMIPS System emulator
+@subsection nanoMIPS System emulator
+@cindex system emulation (nanoMIPS)
+
+Executable @file{qemu-system-mipsel} also covers simulation of
+32-bit nanoMIPS system in little endian mode:
+
+@itemize @minus
+@item
+nanoMIPS I7200 CPU
+@end itemize
+
+Example of @file{qemu-system-mipsel} usage for nanoMIPS is shown below:
+
+Download @code{<disk_image_file>} from @url{https://mipsdistros.mips.com/LinuxDistro/nanomips/buildroot/index.html}.
+
+Download @code{<kernel_image_file>} from @url{https://mipsdistros.mips.com/LinuxDistro/nanomips/kernels/v4.15.18-432-gb2eb9a8b07a1-20180627102142/index.html}.
+
+Start system emulation of Malta board with nanoMIPS I7200 CPU:
+@example
+qemu-system-mipsel -cpu I7200 -kernel @code{<kernel_image_file>} \
+    -M malta -serial stdio -m @code{<memory_size>} -hda @code{<disk_image_file>} \
+    -append "mem=256m@@0x0 rw console=ttyS0 vga=cirrus vesa=0x111 root=/dev/sda"
+@end example
+
+
diff --git a/docs/system/target-ppc.texi b/docs/system/target-ppc.texi
new file mode 100644
index 00000000000..c2c254d3d23
--- /dev/null
+++ b/docs/system/target-ppc.texi
@@ -0,0 +1,78 @@
+@node PowerPC System emulator
+@section PowerPC System emulator
+@cindex system emulation (PowerPC)
+
+Use the executable @file{qemu-system-ppc} to simulate a complete 40P (PREP)
+or PowerMac PowerPC system.
+
+QEMU emulates the following PowerMac peripherals:
+
+@itemize @minus
+@item
+UniNorth or Grackle PCI Bridge
+@item
+PCI VGA compatible card with VESA Bochs Extensions
+@item
+2 PMAC IDE interfaces with hard disk and CD-ROM support
+@item
+NE2000 PCI adapters
+@item
+Non Volatile RAM
+@item
+VIA-CUDA with ADB keyboard and mouse.
+@end itemize
+
+QEMU emulates the following 40P (PREP) peripherals:
+
+@itemize @minus
+@item
+PCI Bridge
+@item
+PCI VGA compatible card with VESA Bochs Extensions
+@item
+2 IDE interfaces with hard disk and CD-ROM support
+@item
+Floppy disk
+@item
+PCnet network adapters
+@item
+Serial port
+@item
+PREP Non Volatile RAM
+@item
+PC compatible keyboard and mouse.
+@end itemize
+
+Since version 0.9.1, QEMU uses OpenBIOS @url{https://www.openbios.org/}
+for the g3beige and mac99 PowerMac and the 40p machines. OpenBIOS is a free
+(GPL v2) portable firmware implementation. The goal is to implement a 100%
+IEEE 1275-1994 (referred to as Open Firmware) compliant firmware.
+
+@c man begin OPTIONS
+
+The following options are specific to the PowerPC emulation:
+
+@table @option
+
+@item -g @var{W}x@var{H}[x@var{DEPTH}]
+
+Set the initial VGA graphic mode. The default is 800x600x32.
+
+@item -prom-env @var{string}
+
+Set OpenBIOS variables in NVRAM, for example:
+
+@example
+qemu-system-ppc -prom-env 'auto-boot?=false' \
+ -prom-env 'boot-device=hd:2,\yaboot' \
+ -prom-env 'boot-args=conf=hd:2,\yaboot.conf'
+@end example
+
+@end table
+
+@c man end
+
+
+More information is available at
+@url{http://perso.magic.fr/l_indien/qemu-ppc/}.
+
diff --git a/docs/system/target-sparc.texi b/docs/system/target-sparc.texi
new file mode 100644
index 00000000000..7fe0aec9c39
--- /dev/null
+++ b/docs/system/target-sparc.texi
@@ -0,0 +1,96 @@
+@node Sparc32 System emulator
+@section Sparc32 System emulator
+@cindex system emulation (Sparc32)
+
+Use the executable @file{qemu-system-sparc} to simulate the following
+Sun4m architecture machines:
+@itemize @minus
+@item
+SPARCstation 4
+@item
+SPARCstation 5
+@item
+SPARCstation 10
+@item
+SPARCstation 20
+@item
+SPARCserver 600MP
+@item
+SPARCstation LX
+@item
+SPARCstation Voyager
+@item
+SPARCclassic
+@item
+SPARCbook
+@end itemize
+
+The emulation is somewhat complete. SMP up to 16 CPUs is supported,
+but Linux limits the number of usable CPUs to 4.
+
+QEMU emulates the following sun4m peripherals:
+
+@itemize @minus
+@item
+IOMMU
+@item
+TCX or cgthree Frame buffer
+@item
+Lance (Am7990) Ethernet
+@item
+Non Volatile RAM M48T02/M48T08
+@item
+Slave I/O: timers, interrupt controllers, Zilog serial ports, keyboard
+and power/reset logic
+@item
+ESP SCSI controller with hard disk and CD-ROM support
+@item
+Floppy drive (not on SS-600MP)
+@item
+CS4231 sound device (only on SS-5, not working yet)
+@end itemize
+
+The number of peripherals is fixed in the architecture.  Maximum
+memory size depends on the machine type, for SS-5 it is 256MB and for
+others 2047MB.
+
+Since version 0.8.2, QEMU uses OpenBIOS
+@url{https://www.openbios.org/}. OpenBIOS is a free (GPL v2) portable
+firmware implementation. The goal is to implement a 100% IEEE
+1275-1994 (referred to as Open Firmware) compliant firmware.
+
+A sample Linux 2.6 series kernel and ram disk image are available on
+the QEMU web site. There are still issues with NetBSD and OpenBSD, but
+most kernel versions work. Please note that currently older Solaris kernels
+don't work probably due to interface issues between OpenBIOS and
+Solaris.
+
+@c man begin OPTIONS
+
+The following options are specific to the Sparc32 emulation:
+
+@table @option
+
+@item -g @var{W}x@var{H}x[x@var{DEPTH}]
+
+Set the initial graphics mode. For TCX, the default is 1024x768x8 with the
+option of 1024x768x24. For cgthree, the default is 1024x768x8 with the option
+of 1152x900x8 for people who wish to use OBP.
+
+@item -prom-env @var{string}
+
+Set OpenBIOS variables in NVRAM, for example:
+
+@example
+qemu-system-sparc -prom-env 'auto-boot?=false' \
+ -prom-env 'boot-device=sd(0,2,0):d' -prom-env 'boot-args=linux single'
+@end example
+
+@item -M [SS-4|SS-5|SS-10|SS-20|SS-600MP|LX|Voyager|SPARCClassic] [|SPARCbook]
+
+Set the emulated machine type. Default is SS-5.
+
+@end table
+
+@c man end
+
diff --git a/docs/system/target-sparc64.texi b/docs/system/target-sparc64.texi
new file mode 100644
index 00000000000..9e7a27de0ce
--- /dev/null
+++ b/docs/system/target-sparc64.texi
@@ -0,0 +1,61 @@
+@node Sparc64 System emulator
+@section Sparc64 System emulator
+@cindex system emulation (Sparc64)
+
+Use the executable @file{qemu-system-sparc64} to simulate a Sun4u
+(UltraSPARC PC-like machine), Sun4v (T1 PC-like machine), or generic
+Niagara (T1) machine. The Sun4u emulator is mostly complete, being
+able to run Linux, NetBSD and OpenBSD in headless (-nographic) mode. The
+Sun4v emulator is still a work in progress.
+
+The Niagara T1 emulator makes use of firmware and OS binaries supplied in the S10image/ directory
+of the OpenSPARC T1 project @url{http://download.oracle.com/technetwork/systems/opensparc/OpenSPARCT1_Arch.1.5.tar.bz2}
+and is able to boot the disk.s10hw2 Solaris image.
+@example
+qemu-system-sparc64 -M niagara -L /path-to/S10image/ \
+                    -nographic -m 256 \
+                    -drive if=pflash,readonly=on,file=/S10image/disk.s10hw2
+@end example
+
+
+QEMU emulates the following peripherals:
+
+@itemize @minus
+@item
+UltraSparc IIi APB PCI Bridge
+@item
+PCI VGA compatible card with VESA Bochs Extensions
+@item
+PS/2 mouse and keyboard
+@item
+Non Volatile RAM M48T59
+@item
+PC-compatible serial ports
+@item
+2 PCI IDE interfaces with hard disk and CD-ROM support
+@item
+Floppy disk
+@end itemize
+
+@c man begin OPTIONS
+
+The following options are specific to the Sparc64 emulation:
+
+@table @option
+
+@item -prom-env @var{string}
+
+Set OpenBIOS variables in NVRAM, for example:
+
+@example
+qemu-system-sparc64 -prom-env 'auto-boot?=false'
+@end example
+
+@item -M [sun4u|sun4v|niagara]
+
+Set the emulated machine type. The default is sun4u.
+
+@end table
+
+@c man end
+
diff --git a/docs/system/target-xtensa.texi b/docs/system/target-xtensa.texi
new file mode 100644
index 00000000000..08b0b362991
--- /dev/null
+++ b/docs/system/target-xtensa.texi
@@ -0,0 +1,56 @@
+@node Xtensa System emulator
+@section Xtensa System emulator
+@cindex system emulation (Xtensa)
+
+Two executables cover simulation of both Xtensa endian options,
+@file{qemu-system-xtensa} and @file{qemu-system-xtensaeb}.
+Two different machine types are emulated:
+
+@itemize @minus
+@item
+Xtensa emulator pseudo board "sim"
+@item
+Avnet LX60/LX110/LX200 board
+@end itemize
+
+The sim pseudo board emulation provides an environment similar
+to one provided by the proprietary Tensilica ISS.
+It supports:
+
+@itemize @minus
+@item
+A range of Xtensa CPUs, default is the DC232B
+@item
+Console and filesystem access via semihosting calls
+@end itemize
+
+The Avnet LX60/LX110/LX200 emulation supports:
+
+@itemize @minus
+@item
+A range of Xtensa CPUs, default is the DC232B
+@item
+16550 UART
+@item
+OpenCores 10/100 Mbps Ethernet MAC
+@end itemize
+
+@c man begin OPTIONS
+
+The following options are specific to the Xtensa emulation:
+
+@table @option
+
+@item -semihosting
+Enable semihosting syscall emulation.
+
+Xtensa semihosting provides basic file IO calls, such as open/read/write/seek/select.
+Tensilica baremetal libc for ISS and linux platform "sim" use this interface.
+
+Note that this allows guest direct access to the host filesystem,
+so should only be used with trusted guest OS.
+
+@end table
+
+@c man end
+
diff --git a/qemu-doc.texi b/qemu-doc.texi
index 40fab523f35..f702dce4557 100644
--- a/qemu-doc.texi
+++ b/qemu-doc.texi
@@ -176,874 +176,17 @@ various targets are mentioned in the following sections.
 * MIPS System emulator::
 * ARM System emulator::
 * ColdFire System emulator::
-* Cris System emulator::
-* Microblaze System emulator::
-* SH4 System emulator::
 * Xtensa System emulator::
 @end menu
 
-@node x86 (PC) System emulator
-@section x86 (PC) System emulator
-@cindex system emulation (PC)
-
-@menu
-* pcsys_devices::      Peripherals
-* cpu_models_x86::     Supported CPU model configurations on x86 hosts
-* pcsys_req::          OS requirements
-@end menu
-
-@node pcsys_devices
-@subsection Peripherals
-
-@c man begin DESCRIPTION
-
-The QEMU PC System emulator simulates the following peripherals:
-
-@itemize @minus
-@item
-i440FX host PCI bridge and PIIX3 PCI to ISA bridge
-@item
-Cirrus CLGD 5446 PCI VGA card or dummy VGA card with Bochs VESA
-extensions (hardware level, including all non standard modes).
-@item
-PS/2 mouse and keyboard
-@item
-2 PCI IDE interfaces with hard disk and CD-ROM support
-@item
-Floppy disk
-@item
-PCI and ISA network adapters
-@item
-Serial ports
-@item
-IPMI BMC, either and internal or external one
-@item
-Creative SoundBlaster 16 sound card
-@item
-ENSONIQ AudioPCI ES1370 sound card
-@item
-Intel 82801AA AC97 Audio compatible sound card
-@item
-Intel HD Audio Controller and HDA codec
-@item
-Adlib (OPL2) - Yamaha YM3812 compatible chip
-@item
-Gravis Ultrasound GF1 sound card
-@item
-CS4231A compatible sound card
-@item
-PCI UHCI, OHCI, EHCI or XHCI USB controller and a virtual USB-1.1 hub.
-@end itemize
-
-SMP is supported with up to 255 CPUs.
-
-QEMU uses the PC BIOS from the Seabios project and the Plex86/Bochs LGPL
-VGA BIOS.
-
-QEMU uses YM3812 emulation by Tatsuyuki Satoh.
-
-QEMU uses GUS emulation (GUSEMU32 @url{http://www.deinmeister.de/gusemu/})
-by Tibor "TS" Schütz.
-
-Note that, by default, GUS shares IRQ(7) with parallel ports and so
-QEMU must be told to not have parallel ports to have working GUS.
-
-@example
-@value{qemu_system_x86} dos.img -soundhw gus -parallel none
-@end example
-
-Alternatively:
-@example
-@value{qemu_system_x86} dos.img -device gus,irq=5
-@end example
-
-Or some other unclaimed IRQ.
-
-CS4231A is the chip used in Windows Sound System and GUSMAX products
-
-@c man end
-
-@lowersections
-@include docs/system/cpu-models-x86.texi
-@raisesections
-
-@node pcsys_req
-@subsection OS requirements
-
-On x86_64 hosts, the default set of CPU features enabled by the KVM accelerator
-require the host to be running Linux v4.5 or newer.  Red Hat Enterprise Linux
-7 is also supported, since the required functionality was backported.
-
-@node PowerPC System emulator
-@section PowerPC System emulator
-@cindex system emulation (PowerPC)
-
-Use the executable @file{qemu-system-ppc} to simulate a complete 40P (PREP)
-or PowerMac PowerPC system.
-
-QEMU emulates the following PowerMac peripherals:
-
-@itemize @minus
-@item
-UniNorth or Grackle PCI Bridge
-@item
-PCI VGA compatible card with VESA Bochs Extensions
-@item
-2 PMAC IDE interfaces with hard disk and CD-ROM support
-@item
-NE2000 PCI adapters
-@item
-Non Volatile RAM
-@item
-VIA-CUDA with ADB keyboard and mouse.
-@end itemize
-
-QEMU emulates the following 40P (PREP) peripherals:
-
-@itemize @minus
-@item
-PCI Bridge
-@item
-PCI VGA compatible card with VESA Bochs Extensions
-@item
-2 IDE interfaces with hard disk and CD-ROM support
-@item
-Floppy disk
-@item
-PCnet network adapters
-@item
-Serial port
-@item
-PREP Non Volatile RAM
-@item
-PC compatible keyboard and mouse.
-@end itemize
-
-Since version 0.9.1, QEMU uses OpenBIOS @url{https://www.openbios.org/}
-for the g3beige and mac99 PowerMac and the 40p machines. OpenBIOS is a free
-(GPL v2) portable firmware implementation. The goal is to implement a 100%
-IEEE 1275-1994 (referred to as Open Firmware) compliant firmware.
-
-@c man begin OPTIONS
-
-The following options are specific to the PowerPC emulation:
-
-@table @option
-
-@item -g @var{W}x@var{H}[x@var{DEPTH}]
-
-Set the initial VGA graphic mode. The default is 800x600x32.
-
-@item -prom-env @var{string}
-
-Set OpenBIOS variables in NVRAM, for example:
-
-@example
-qemu-system-ppc -prom-env 'auto-boot?=false' \
- -prom-env 'boot-device=hd:2,\yaboot' \
- -prom-env 'boot-args=conf=hd:2,\yaboot.conf'
-@end example
-
-@end table
-
-@c man end
-
-
-More information is available at
-@url{http://perso.magic.fr/l_indien/qemu-ppc/}.
-
-@node Sparc32 System emulator
-@section Sparc32 System emulator
-@cindex system emulation (Sparc32)
-
-Use the executable @file{qemu-system-sparc} to simulate the following
-Sun4m architecture machines:
-@itemize @minus
-@item
-SPARCstation 4
-@item
-SPARCstation 5
-@item
-SPARCstation 10
-@item
-SPARCstation 20
-@item
-SPARCserver 600MP
-@item
-SPARCstation LX
-@item
-SPARCstation Voyager
-@item
-SPARCclassic
-@item
-SPARCbook
-@end itemize
-
-The emulation is somewhat complete. SMP up to 16 CPUs is supported,
-but Linux limits the number of usable CPUs to 4.
-
-QEMU emulates the following sun4m peripherals:
-
-@itemize @minus
-@item
-IOMMU
-@item
-TCX or cgthree Frame buffer
-@item
-Lance (Am7990) Ethernet
-@item
-Non Volatile RAM M48T02/M48T08
-@item
-Slave I/O: timers, interrupt controllers, Zilog serial ports, keyboard
-and power/reset logic
-@item
-ESP SCSI controller with hard disk and CD-ROM support
-@item
-Floppy drive (not on SS-600MP)
-@item
-CS4231 sound device (only on SS-5, not working yet)
-@end itemize
-
-The number of peripherals is fixed in the architecture.  Maximum
-memory size depends on the machine type, for SS-5 it is 256MB and for
-others 2047MB.
-
-Since version 0.8.2, QEMU uses OpenBIOS
-@url{https://www.openbios.org/}. OpenBIOS is a free (GPL v2) portable
-firmware implementation. The goal is to implement a 100% IEEE
-1275-1994 (referred to as Open Firmware) compliant firmware.
-
-A sample Linux 2.6 series kernel and ram disk image are available on
-the QEMU web site. There are still issues with NetBSD and OpenBSD, but
-most kernel versions work. Please note that currently older Solaris kernels
-don't work probably due to interface issues between OpenBIOS and
-Solaris.
-
-@c man begin OPTIONS
-
-The following options are specific to the Sparc32 emulation:
-
-@table @option
-
-@item -g @var{W}x@var{H}x[x@var{DEPTH}]
-
-Set the initial graphics mode. For TCX, the default is 1024x768x8 with the
-option of 1024x768x24. For cgthree, the default is 1024x768x8 with the option
-of 1152x900x8 for people who wish to use OBP.
-
-@item -prom-env @var{string}
-
-Set OpenBIOS variables in NVRAM, for example:
-
-@example
-qemu-system-sparc -prom-env 'auto-boot?=false' \
- -prom-env 'boot-device=sd(0,2,0):d' -prom-env 'boot-args=linux single'
-@end example
-
-@item -M [SS-4|SS-5|SS-10|SS-20|SS-600MP|LX|Voyager|SPARCClassic] [|SPARCbook]
-
-Set the emulated machine type. Default is SS-5.
-
-@end table
-
-@c man end
-
-@node Sparc64 System emulator
-@section Sparc64 System emulator
-@cindex system emulation (Sparc64)
-
-Use the executable @file{qemu-system-sparc64} to simulate a Sun4u
-(UltraSPARC PC-like machine), Sun4v (T1 PC-like machine), or generic
-Niagara (T1) machine. The Sun4u emulator is mostly complete, being
-able to run Linux, NetBSD and OpenBSD in headless (-nographic) mode. The
-Sun4v emulator is still a work in progress.
-
-The Niagara T1 emulator makes use of firmware and OS binaries supplied in the S10image/ directory
-of the OpenSPARC T1 project @url{http://download.oracle.com/technetwork/systems/opensparc/OpenSPARCT1_Arch.1.5.tar.bz2}
-and is able to boot the disk.s10hw2 Solaris image.
-@example
-qemu-system-sparc64 -M niagara -L /path-to/S10image/ \
-                    -nographic -m 256 \
-                    -drive if=pflash,readonly=on,file=/S10image/disk.s10hw2
-@end example
-
-
-QEMU emulates the following peripherals:
-
-@itemize @minus
-@item
-UltraSparc IIi APB PCI Bridge
-@item
-PCI VGA compatible card with VESA Bochs Extensions
-@item
-PS/2 mouse and keyboard
-@item
-Non Volatile RAM M48T59
-@item
-PC-compatible serial ports
-@item
-2 PCI IDE interfaces with hard disk and CD-ROM support
-@item
-Floppy disk
-@end itemize
-
-@c man begin OPTIONS
-
-The following options are specific to the Sparc64 emulation:
-
-@table @option
-
-@item -prom-env @var{string}
-
-Set OpenBIOS variables in NVRAM, for example:
-
-@example
-qemu-system-sparc64 -prom-env 'auto-boot?=false'
-@end example
-
-@item -M [sun4u|sun4v|niagara]
-
-Set the emulated machine type. The default is sun4u.
-
-@end table
-
-@c man end
-
-@node MIPS System emulator
-@section MIPS System emulator
-@cindex system emulation (MIPS)
-
-@menu
-* recommendations_cpu_models_MIPS:: Supported CPU model configurations on MIPS hosts
-* nanoMIPS System emulator ::
-@end menu
-
-Four executables cover simulation of 32 and 64-bit MIPS systems in
-both endian options, @file{qemu-system-mips}, @file{qemu-system-mipsel}
-@file{qemu-system-mips64} and @file{qemu-system-mips64el}.
-Five different machine types are emulated:
-
-@itemize @minus
-@item
-A generic ISA PC-like machine "mips"
-@item
-The MIPS Malta prototype board "malta"
-@item
-An ACER Pica "pica61". This machine needs the 64-bit emulator.
-@item
-MIPS emulator pseudo board "mipssim"
-@item
-A MIPS Magnum R4000 machine "magnum". This machine needs the 64-bit emulator.
-@end itemize
-
-The generic emulation is supported by Debian 'Etch' and is able to
-install Debian into a virtual disk image. The following devices are
-emulated:
-
-@itemize @minus
-@item
-A range of MIPS CPUs, default is the 24Kf
-@item
-PC style serial port
-@item
-PC style IDE disk
-@item
-NE2000 network card
-@end itemize
-
-The Malta emulation supports the following devices:
-
-@itemize @minus
-@item
-Core board with MIPS 24Kf CPU and Galileo system controller
-@item
-PIIX4 PCI/USB/SMbus controller
-@item
-The Multi-I/O chip's serial device
-@item
-PCI network cards (PCnet32 and others)
-@item
-Malta FPGA serial device
-@item
-Cirrus (default) or any other PCI VGA graphics card
-@end itemize
-
-The Boston board emulation supports the following devices:
-
-@itemize @minus
-@item
-Xilinx FPGA, which includes a PCIe root port and an UART
-@item
-Intel EG20T PCH connects the I/O peripherals, but only the SATA bus is emulated
-@end itemize
-
-The ACER Pica emulation supports:
-
-@itemize @minus
-@item
-MIPS R4000 CPU
-@item
-PC-style IRQ and DMA controllers
-@item
-PC Keyboard
-@item
-IDE controller
-@end itemize
-
-The MIPS Magnum R4000 emulation supports:
-
-@itemize @minus
-@item
-MIPS R4000 CPU
-@item
-PC-style IRQ controller
-@item
-PC Keyboard
-@item
-SCSI controller
-@item
-G364 framebuffer
-@end itemize
-
-The Fulong 2E emulation supports:
-
-@itemize @minus
-@item
-Loongson 2E CPU
-@item
-Bonito64 system controller as North Bridge
-@item
-VT82C686 chipset as South Bridge
-@item
-RTL8139D as a network card chipset
-@end itemize
-
-The mipssim pseudo board emulation provides an environment similar
-to what the proprietary MIPS emulator uses for running Linux.
-It supports:
-
-@itemize @minus
-@item
-A range of MIPS CPUs, default is the 24Kf
-@item
-PC style serial port
-@item
-MIPSnet network emulation
-@end itemize
-
-@lowersections
-@include docs/system/cpu-models-mips.texi
-@raisesections
-
-@node nanoMIPS System emulator
-@subsection nanoMIPS System emulator
-@cindex system emulation (nanoMIPS)
-
-Executable @file{qemu-system-mipsel} also covers simulation of
-32-bit nanoMIPS system in little endian mode:
-
-@itemize @minus
-@item
-nanoMIPS I7200 CPU
-@end itemize
-
-Example of @file{qemu-system-mipsel} usage for nanoMIPS is shown below:
-
-Download @code{<disk_image_file>} from @url{https://mipsdistros.mips.com/LinuxDistro/nanomips/buildroot/index.html}.
-
-Download @code{<kernel_image_file>} from @url{https://mipsdistros.mips.com/LinuxDistro/nanomips/kernels/v4.15.18-432-gb2eb9a8b07a1-20180627102142/index.html}.
-
-Start system emulation of Malta board with nanoMIPS I7200 CPU:
-@example
-qemu-system-mipsel -cpu I7200 -kernel @code{<kernel_image_file>} \
-    -M malta -serial stdio -m @code{<memory_size>} -hda @code{<disk_image_file>} \
-    -append "mem=256m@@0x0 rw console=ttyS0 vga=cirrus vesa=0x111 root=/dev/sda"
-@end example
-
-
-@node ARM System emulator
-@section ARM System emulator
-@cindex system emulation (ARM)
-
-Use the executable @file{qemu-system-arm} to simulate a ARM
-machine. The ARM Integrator/CP board is emulated with the following
-devices:
-
-@itemize @minus
-@item
-ARM926E, ARM1026E, ARM946E, ARM1136 or Cortex-A8 CPU
-@item
-Two PL011 UARTs
-@item
-SMC 91c111 Ethernet adapter
-@item
-PL110 LCD controller
-@item
-PL050 KMI with PS/2 keyboard and mouse.
-@item
-PL181 MultiMedia Card Interface with SD card.
-@end itemize
-
-The ARM Versatile baseboard is emulated with the following devices:
-
-@itemize @minus
-@item
-ARM926E, ARM1136 or Cortex-A8 CPU
-@item
-PL190 Vectored Interrupt Controller
-@item
-Four PL011 UARTs
-@item
-SMC 91c111 Ethernet adapter
-@item
-PL110 LCD controller
-@item
-PL050 KMI with PS/2 keyboard and mouse.
-@item
-PCI host bridge.  Note the emulated PCI bridge only provides access to
-PCI memory space.  It does not provide access to PCI IO space.
-This means some devices (eg. ne2k_pci NIC) are not usable, and others
-(eg. rtl8139 NIC) are only usable when the guest drivers use the memory
-mapped control registers.
-@item
-PCI OHCI USB controller.
-@item
-LSI53C895A PCI SCSI Host Bus Adapter with hard disk and CD-ROM devices.
-@item
-PL181 MultiMedia Card Interface with SD card.
-@end itemize
-
-Several variants of the ARM RealView baseboard are emulated,
-including the EB, PB-A8 and PBX-A9.  Due to interactions with the
-bootloader, only certain Linux kernel configurations work out
-of the box on these boards.
-
-Kernels for the PB-A8 board should have CONFIG_REALVIEW_HIGH_PHYS_OFFSET
-enabled in the kernel, and expect 512M RAM.  Kernels for The PBX-A9 board
-should have CONFIG_SPARSEMEM enabled, CONFIG_REALVIEW_HIGH_PHYS_OFFSET
-disabled and expect 1024M RAM.
-
-The following devices are emulated:
-
-@itemize @minus
-@item
-ARM926E, ARM1136, ARM11MPCore, Cortex-A8 or Cortex-A9 MPCore CPU
-@item
-ARM AMBA Generic/Distributed Interrupt Controller
-@item
-Four PL011 UARTs
-@item
-SMC 91c111 or SMSC LAN9118 Ethernet adapter
-@item
-PL110 LCD controller
-@item
-PL050 KMI with PS/2 keyboard and mouse
-@item
-PCI host bridge
-@item
-PCI OHCI USB controller
-@item
-LSI53C895A PCI SCSI Host Bus Adapter with hard disk and CD-ROM devices
-@item
-PL181 MultiMedia Card Interface with SD card.
-@end itemize
-
-The XScale-based clamshell PDA models ("Spitz", "Akita", "Borzoi"
-and "Terrier") emulation includes the following peripherals:
-
-@itemize @minus
-@item
-Intel PXA270 System-on-chip (ARM V5TE core)
-@item
-NAND Flash memory
-@item
-IBM/Hitachi DSCM microdrive in a PXA PCMCIA slot - not in "Akita"
-@item
-On-chip OHCI USB controller
-@item
-On-chip LCD controller
-@item
-On-chip Real Time Clock
-@item
-TI ADS7846 touchscreen controller on SSP bus
-@item
-Maxim MAX1111 analog-digital converter on I@math{^2}C bus
-@item
-GPIO-connected keyboard controller and LEDs
-@item
-Secure Digital card connected to PXA MMC/SD host
-@item
-Three on-chip UARTs
-@item
-WM8750 audio CODEC on I@math{^2}C and I@math{^2}S busses
-@end itemize
-
-The Palm Tungsten|E PDA (codename "Cheetah") emulation includes the
-following elements:
-
-@itemize @minus
-@item
-Texas Instruments OMAP310 System-on-chip (ARM 925T core)
-@item
-ROM and RAM memories (ROM firmware image can be loaded with -option-rom)
-@item
-On-chip LCD controller
-@item
-On-chip Real Time Clock
-@item
-TI TSC2102i touchscreen controller / analog-digital converter / Audio
-CODEC, connected through MicroWire and I@math{^2}S busses
-@item
-GPIO-connected matrix keypad
-@item
-Secure Digital card connected to OMAP MMC/SD host
-@item
-Three on-chip UARTs
-@end itemize
-
-Nokia N800 and N810 internet tablets (known also as RX-34 and RX-44 / 48)
-emulation supports the following elements:
-
-@itemize @minus
-@item
-Texas Instruments OMAP2420 System-on-chip (ARM 1136 core)
-@item
-RAM and non-volatile OneNAND Flash memories
-@item
-Display connected to EPSON remote framebuffer chip and OMAP on-chip
-display controller and a LS041y3 MIPI DBI-C controller
-@item
-TI TSC2301 (in N800) and TI TSC2005 (in N810) touchscreen controllers
-driven through SPI bus
-@item
-National Semiconductor LM8323-controlled qwerty keyboard driven
-through I@math{^2}C bus
-@item
-Secure Digital card connected to OMAP MMC/SD host
-@item
-Three OMAP on-chip UARTs and on-chip STI debugging console
-@item
-Mentor Graphics "Inventra" dual-role USB controller embedded in a TI
-TUSB6010 chip - only USB host mode is supported
-@item
-TI TMP105 temperature sensor driven through I@math{^2}C bus
-@item
-TI TWL92230C power management companion with an RTC on I@math{^2}C bus
-@item
-Nokia RETU and TAHVO multi-purpose chips with an RTC, connected
-through CBUS
-@end itemize
-
-The Luminary Micro Stellaris LM3S811EVB emulation includes the following
-devices:
-
-@itemize @minus
-@item
-Cortex-M3 CPU core.
-@item
-64k Flash and 8k SRAM.
-@item
-Timers, UARTs, ADC and I@math{^2}C interface.
-@item
-OSRAM Pictiva 96x16 OLED with SSD0303 controller on I@math{^2}C bus.
-@end itemize
-
-The Luminary Micro Stellaris LM3S6965EVB emulation includes the following
-devices:
-
-@itemize @minus
-@item
-Cortex-M3 CPU core.
-@item
-256k Flash and 64k SRAM.
-@item
-Timers, UARTs, ADC, I@math{^2}C and SSI interfaces.
-@item
-OSRAM Pictiva 128x64 OLED with SSD0323 controller connected via SSI.
-@end itemize
-
-The Freecom MusicPal internet radio emulation includes the following
-elements:
-
-@itemize @minus
-@item
-Marvell MV88W8618 ARM core.
-@item
-32 MB RAM, 256 KB SRAM, 8 MB flash.
-@item
-Up to 2 16550 UARTs
-@item
-MV88W8xx8 Ethernet controller
-@item
-MV88W8618 audio controller, WM8750 CODEC and mixer
-@item
-128×64 display with brightness control
-@item
-2 buttons, 2 navigation wheels with button function
-@end itemize
-
-The Siemens SX1 models v1 and v2 (default) basic emulation.
-The emulation includes the following elements:
-
-@itemize @minus
-@item
-Texas Instruments OMAP310 System-on-chip (ARM 925T core)
-@item
-ROM and RAM memories (ROM firmware image can be loaded with -pflash)
-V1
-1 Flash of 16MB and 1 Flash of 8MB
-V2
-1 Flash of 32MB
-@item
-On-chip LCD controller
-@item
-On-chip Real Time Clock
-@item
-Secure Digital card connected to OMAP MMC/SD host
-@item
-Three on-chip UARTs
-@end itemize
-
-A Linux 2.6 test image is available on the QEMU web site. More
-information is available in the QEMU mailing-list archive.
-
-@c man begin OPTIONS
-
-The following options are specific to the ARM emulation:
-
-@table @option
-
-@item -semihosting
-Enable semihosting syscall emulation.
-
-On ARM this implements the "Angel" interface.
-
-Note that this allows guest direct access to the host filesystem,
-so should only be used with trusted guest OS.
-
-@end table
-
-@c man end
-
-@node ColdFire System emulator
-@section ColdFire System emulator
-@cindex system emulation (ColdFire)
-@cindex system emulation (M68K)
-
-Use the executable @file{qemu-system-m68k} to simulate a ColdFire machine.
-The emulator is able to boot a uClinux kernel.
-
-The M5208EVB emulation includes the following devices:
-
-@itemize @minus
-@item
-MCF5208 ColdFire V2 Microprocessor (ISA A+ with EMAC).
-@item
-Three Two on-chip UARTs.
-@item
-Fast Ethernet Controller (FEC)
-@end itemize
-
-The AN5206 emulation includes the following devices:
-
-@itemize @minus
-@item
-MCF5206 ColdFire V2 Microprocessor.
-@item
-Two on-chip UARTs.
-@end itemize
-
-@c man begin OPTIONS
-
-The following options are specific to the ColdFire emulation:
-
-@table @option
-
-@item -semihosting
-Enable semihosting syscall emulation.
-
-On M68K this implements the "ColdFire GDB" interface used by libgloss.
-
-Note that this allows guest direct access to the host filesystem,
-so should only be used with trusted guest OS.
-
-@end table
-
-@c man end
-
-@node Cris System emulator
-@section Cris System emulator
-@cindex system emulation (Cris)
-
-TODO
-
-@node Microblaze System emulator
-@section Microblaze System emulator
-@cindex system emulation (Microblaze)
-
-TODO
-
-@node SH4 System emulator
-@section SH4 System emulator
-@cindex system emulation (SH4)
-
-TODO
-
-@node Xtensa System emulator
-@section Xtensa System emulator
-@cindex system emulation (Xtensa)
-
-Two executables cover simulation of both Xtensa endian options,
-@file{qemu-system-xtensa} and @file{qemu-system-xtensaeb}.
-Two different machine types are emulated:
-
-@itemize @minus
-@item
-Xtensa emulator pseudo board "sim"
-@item
-Avnet LX60/LX110/LX200 board
-@end itemize
-
-The sim pseudo board emulation provides an environment similar
-to one provided by the proprietary Tensilica ISS.
-It supports:
-
-@itemize @minus
-@item
-A range of Xtensa CPUs, default is the DC232B
-@item
-Console and filesystem access via semihosting calls
-@end itemize
-
-The Avnet LX60/LX110/LX200 emulation supports:
-
-@itemize @minus
-@item
-A range of Xtensa CPUs, default is the DC232B
-@item
-16550 UART
-@item
-OpenCores 10/100 Mbps Ethernet MAC
-@end itemize
-
-@c man begin OPTIONS
-
-The following options are specific to the Xtensa emulation:
-
-@table @option
-
-@item -semihosting
-Enable semihosting syscall emulation.
-
-Xtensa semihosting provides basic file IO calls, such as open/read/write/seek/select.
-Tensilica baremetal libc for ISS and linux platform "sim" use this interface.
-
-Note that this allows guest direct access to the host filesystem,
-so should only be used with trusted guest OS.
-
-@end table
-
-@c man end
+@include docs/system/target-i386.texi
+@include docs/system/target-ppc.texi
+@include docs/system/target-sparc.texi
+@include docs/system/target-sparc64.texi
+@include docs/system/target-mips.texi
+@include docs/system/target-arm.texi
+@include docs/system/target-m68k.texi
+@include docs/system/target-xtensa.texi
 
 @include docs/security.texi
 
-- 
2.20.1

Peter Maydell <peter.maydell@linaro.org> writes:

> From: Paolo Bonzini <pbonzini@redhat.com>
>
> Signed-off-by: Paolo Bonzini <pbonzini@redhat.com>
> Message-id: 20200226113034.6741-9-pbonzini@redhat.com
> Reviewed-by: Peter Maydell <peter.maydell@linaro.org>
> Signed-off-by: Peter Maydell <peter.maydell@linaro.org>

Reviewed-by: Alex Bennée <alex.bennee@linaro.org>

> ---
>  docs/system/target-arm.texi     | 264 ++++++++++
>  docs/system/target-i386.texi    |  92 ++++
>  docs/system/target-m68k.texi    |  46 ++
>  docs/system/target-mips.texi    | 152 ++++++
>  docs/system/target-ppc.texi     |  78 +++
>  docs/system/target-sparc.texi   |  96 ++++
>  docs/system/target-sparc64.texi |  61 +++
>  docs/system/target-xtensa.texi  |  56 ++
>  qemu-doc.texi                   | 873 +-------------------------------
>  9 files changed, 853 insertions(+), 865 deletions(-)
>  create mode 100644 docs/system/target-arm.texi
>  create mode 100644 docs/system/target-i386.texi
>  create mode 100644 docs/system/target-m68k.texi
>  create mode 100644 docs/system/target-mips.texi
>  create mode 100644 docs/system/target-ppc.texi
>  create mode 100644 docs/system/target-sparc.texi
>  create mode 100644 docs/system/target-sparc64.texi
>  create mode 100644 docs/system/target-xtensa.texi
>
> diff --git a/docs/system/target-arm.texi b/docs/system/target-arm.texi
> new file mode 100644
> index 00000000000..040d77b5e05
> --- /dev/null
> +++ b/docs/system/target-arm.texi
> @@ -0,0 +1,264 @@
> +@node ARM System emulator
> +@section ARM System emulator
> +@cindex system emulation (ARM)
> +
> +Use the executable @file{qemu-system-arm} to simulate a ARM
> +machine. The ARM Integrator/CP board is emulated with the following
> +devices:
> +
> +@itemize @minus
> +@item
> +ARM926E, ARM1026E, ARM946E, ARM1136 or Cortex-A8 CPU
> +@item
> +Two PL011 UARTs
> +@item
> +SMC 91c111 Ethernet adapter
> +@item
> +PL110 LCD controller
> +@item
> +PL050 KMI with PS/2 keyboard and mouse.
> +@item
> +PL181 MultiMedia Card Interface with SD card.
> +@end itemize
> +
> +The ARM Versatile baseboard is emulated with the following devices:
> +
> +@itemize @minus
> +@item
> +ARM926E, ARM1136 or Cortex-A8 CPU
> +@item
> +PL190 Vectored Interrupt Controller
> +@item
> +Four PL011 UARTs
> +@item
> +SMC 91c111 Ethernet adapter
> +@item
> +PL110 LCD controller
> +@item
> +PL050 KMI with PS/2 keyboard and mouse.
> +@item
> +PCI host bridge.  Note the emulated PCI bridge only provides access to
> +PCI memory space.  It does not provide access to PCI IO space.
> +This means some devices (eg. ne2k_pci NIC) are not usable, and others
> +(eg. rtl8139 NIC) are only usable when the guest drivers use the memory
> +mapped control registers.
> +@item
> +PCI OHCI USB controller.
> +@item
> +LSI53C895A PCI SCSI Host Bus Adapter with hard disk and CD-ROM devices.
> +@item
> +PL181 MultiMedia Card Interface with SD card.
> +@end itemize
> +
> +Several variants of the ARM RealView baseboard are emulated,
> +including the EB, PB-A8 and PBX-A9.  Due to interactions with the
> +bootloader, only certain Linux kernel configurations work out
> +of the box on these boards.
> +
> +Kernels for the PB-A8 board should have CONFIG_REALVIEW_HIGH_PHYS_OFFSET
> +enabled in the kernel, and expect 512M RAM.  Kernels for The PBX-A9 board
> +should have CONFIG_SPARSEMEM enabled, CONFIG_REALVIEW_HIGH_PHYS_OFFSET
> +disabled and expect 1024M RAM.
> +
> +The following devices are emulated:
> +
> +@itemize @minus
> +@item
> +ARM926E, ARM1136, ARM11MPCore, Cortex-A8 or Cortex-A9 MPCore CPU
> +@item
> +ARM AMBA Generic/Distributed Interrupt Controller
> +@item
> +Four PL011 UARTs
> +@item
> +SMC 91c111 or SMSC LAN9118 Ethernet adapter
> +@item
> +PL110 LCD controller
> +@item
> +PL050 KMI with PS/2 keyboard and mouse
> +@item
> +PCI host bridge
> +@item
> +PCI OHCI USB controller
> +@item
> +LSI53C895A PCI SCSI Host Bus Adapter with hard disk and CD-ROM devices
> +@item
> +PL181 MultiMedia Card Interface with SD card.
> +@end itemize
> +
> +The XScale-based clamshell PDA models ("Spitz", "Akita", "Borzoi"
> +and "Terrier") emulation includes the following peripherals:
> +
> +@itemize @minus
> +@item
> +Intel PXA270 System-on-chip (ARM V5TE core)
> +@item
> +NAND Flash memory
> +@item
> +IBM/Hitachi DSCM microdrive in a PXA PCMCIA slot - not in "Akita"
> +@item
> +On-chip OHCI USB controller
> +@item
> +On-chip LCD controller
> +@item
> +On-chip Real Time Clock
> +@item
> +TI ADS7846 touchscreen controller on SSP bus
> +@item
> +Maxim MAX1111 analog-digital converter on I@math{^2}C bus
> +@item
> +GPIO-connected keyboard controller and LEDs
> +@item
> +Secure Digital card connected to PXA MMC/SD host
> +@item
> +Three on-chip UARTs
> +@item
> +WM8750 audio CODEC on I@math{^2}C and I@math{^2}S busses
> +@end itemize
> +
> +The Palm Tungsten|E PDA (codename "Cheetah") emulation includes the
> +following elements:
> +
> +@itemize @minus
> +@item
> +Texas Instruments OMAP310 System-on-chip (ARM 925T core)
> +@item
> +ROM and RAM memories (ROM firmware image can be loaded with -option-rom)
> +@item
> +On-chip LCD controller
> +@item
> +On-chip Real Time Clock
> +@item
> +TI TSC2102i touchscreen controller / analog-digital converter / Audio
> +CODEC, connected through MicroWire and I@math{^2}S busses
> +@item
> +GPIO-connected matrix keypad
> +@item
> +Secure Digital card connected to OMAP MMC/SD host
> +@item
> +Three on-chip UARTs
> +@end itemize
> +
> +Nokia N800 and N810 internet tablets (known also as RX-34 and RX-44 / 48)
> +emulation supports the following elements:
> +
> +@itemize @minus
> +@item
> +Texas Instruments OMAP2420 System-on-chip (ARM 1136 core)
> +@item
> +RAM and non-volatile OneNAND Flash memories
> +@item
> +Display connected to EPSON remote framebuffer chip and OMAP on-chip
> +display controller and a LS041y3 MIPI DBI-C controller
> +@item
> +TI TSC2301 (in N800) and TI TSC2005 (in N810) touchscreen controllers
> +driven through SPI bus
> +@item
> +National Semiconductor LM8323-controlled qwerty keyboard driven
> +through I@math{^2}C bus
> +@item
> +Secure Digital card connected to OMAP MMC/SD host
> +@item
> +Three OMAP on-chip UARTs and on-chip STI debugging console
> +@item
> +Mentor Graphics "Inventra" dual-role USB controller embedded in a TI
> +TUSB6010 chip - only USB host mode is supported
> +@item
> +TI TMP105 temperature sensor driven through I@math{^2}C bus
> +@item
> +TI TWL92230C power management companion with an RTC on I@math{^2}C bus
> +@item
> +Nokia RETU and TAHVO multi-purpose chips with an RTC, connected
> +through CBUS
> +@end itemize
> +
> +The Luminary Micro Stellaris LM3S811EVB emulation includes the following
> +devices:
> +
> +@itemize @minus
> +@item
> +Cortex-M3 CPU core.
> +@item
> +64k Flash and 8k SRAM.
> +@item
> +Timers, UARTs, ADC and I@math{^2}C interface.
> +@item
> +OSRAM Pictiva 96x16 OLED with SSD0303 controller on I@math{^2}C bus.
> +@end itemize
> +
> +The Luminary Micro Stellaris LM3S6965EVB emulation includes the following
> +devices:
> +
> +@itemize @minus
> +@item
> +Cortex-M3 CPU core.
> +@item
> +256k Flash and 64k SRAM.
> +@item
> +Timers, UARTs, ADC, I@math{^2}C and SSI interfaces.
> +@item
> +OSRAM Pictiva 128x64 OLED with SSD0323 controller connected via SSI.
> +@end itemize
> +
> +The Freecom MusicPal internet radio emulation includes the following
> +elements:
> +
> +@itemize @minus
> +@item
> +Marvell MV88W8618 ARM core.
> +@item
> +32 MB RAM, 256 KB SRAM, 8 MB flash.
> +@item
> +Up to 2 16550 UARTs
> +@item
> +MV88W8xx8 Ethernet controller
> +@item
> +MV88W8618 audio controller, WM8750 CODEC and mixer
> +@item
> +128×64 display with brightness control
> +@item
> +2 buttons, 2 navigation wheels with button function
> +@end itemize
> +
> +The Siemens SX1 models v1 and v2 (default) basic emulation.
> +The emulation includes the following elements:
> +
> +@itemize @minus
> +@item
> +Texas Instruments OMAP310 System-on-chip (ARM 925T core)
> +@item
> +ROM and RAM memories (ROM firmware image can be loaded with -pflash)
> +V1
> +1 Flash of 16MB and 1 Flash of 8MB
> +V2
> +1 Flash of 32MB
> +@item
> +On-chip LCD controller
> +@item
> +On-chip Real Time Clock
> +@item
> +Secure Digital card connected to OMAP MMC/SD host
> +@item
> +Three on-chip UARTs
> +@end itemize
> +
> +A Linux 2.6 test image is available on the QEMU web site. More
> +information is available in the QEMU mailing-list archive.
> +
> +@c man begin OPTIONS
> +
> +The following options are specific to the ARM emulation:
> +
> +@table @option
> +
> +@item -semihosting
> +Enable semihosting syscall emulation.
> +
> +On ARM this implements the "Angel" interface.
> +
> +Note that this allows guest direct access to the host filesystem,
> +so should only be used with trusted guest OS.
> +
> +@end table
> +
> +@c man end
> +
> diff --git a/docs/system/target-i386.texi b/docs/system/target-i386.texi
> new file mode 100644
> index 00000000000..edd23fa8df5
> --- /dev/null
> +++ b/docs/system/target-i386.texi
> @@ -0,0 +1,92 @@
> +@node x86 (PC) System emulator
> +@section x86 (PC) System emulator
> +@cindex system emulation (PC)
> +
> +@menu
> +* pcsys_devices::      Peripherals
> +* cpu_models_x86::     CPU models
> +* pcsys_req::          OS requirements
> +@end menu
> +
> +@node pcsys_devices
> +@subsection Peripherals
> +
> +@c man begin DESCRIPTION
> +
> +The QEMU PC System emulator simulates the following peripherals:
> +
> +@itemize @minus
> +@item
> +i440FX host PCI bridge and PIIX3 PCI to ISA bridge
> +@item
> +Cirrus CLGD 5446 PCI VGA card or dummy VGA card with Bochs VESA
> +extensions (hardware level, including all non standard modes).
> +@item
> +PS/2 mouse and keyboard
> +@item
> +2 PCI IDE interfaces with hard disk and CD-ROM support
> +@item
> +Floppy disk
> +@item
> +PCI and ISA network adapters
> +@item
> +Serial ports
> +@item
> +IPMI BMC, either and internal or external one
> +@item
> +Creative SoundBlaster 16 sound card
> +@item
> +ENSONIQ AudioPCI ES1370 sound card
> +@item
> +Intel 82801AA AC97 Audio compatible sound card
> +@item
> +Intel HD Audio Controller and HDA codec
> +@item
> +Adlib (OPL2) - Yamaha YM3812 compatible chip
> +@item
> +Gravis Ultrasound GF1 sound card
> +@item
> +CS4231A compatible sound card
> +@item
> +PCI UHCI, OHCI, EHCI or XHCI USB controller and a virtual USB-1.1 hub.
> +@end itemize
> +
> +SMP is supported with up to 255 CPUs.
> +
> +QEMU uses the PC BIOS from the Seabios project and the Plex86/Bochs LGPL
> +VGA BIOS.
> +
> +QEMU uses YM3812 emulation by Tatsuyuki Satoh.
> +
> +QEMU uses GUS emulation (GUSEMU32 @url{http://www.deinmeister.de/gusemu/})
> +by Tibor "TS" Schütz.
> +
> +Note that, by default, GUS shares IRQ(7) with parallel ports and so
> +QEMU must be told to not have parallel ports to have working GUS.
> +
> +@example
> +@value{qemu_system_x86} dos.img -soundhw gus -parallel none
> +@end example
> +
> +Alternatively:
> +@example
> +@value{qemu_system_x86} dos.img -device gus,irq=5
> +@end example
> +
> +Or some other unclaimed IRQ.
> +
> +CS4231A is the chip used in Windows Sound System and GUSMAX products
> +
> +@c man end
> +
> +@lowersections
> +@include docs/system/cpu-models-x86.texi
> +@raisesections
> +
> +@node pcsys_req
> +@subsection OS requirements
> +
> +On x86_64 hosts, the default set of CPU features enabled by the KVM accelerator
> +require the host to be running Linux v4.5 or newer.  Red Hat Enterprise Linux
> +7 is also supported, since the required functionality was backported.
> +
> diff --git a/docs/system/target-m68k.texi b/docs/system/target-m68k.texi
> new file mode 100644
> index 00000000000..b5bc9df40ae
> --- /dev/null
> +++ b/docs/system/target-m68k.texi
> @@ -0,0 +1,46 @@
> +@node ColdFire System emulator
> +@section ColdFire System emulator
> +@cindex system emulation (ColdFire)
> +@cindex system emulation (M68K)
> +
> +Use the executable @file{qemu-system-m68k} to simulate a ColdFire machine.
> +The emulator is able to boot a uClinux kernel.
> +
> +The M5208EVB emulation includes the following devices:
> +
> +@itemize @minus
> +@item
> +MCF5208 ColdFire V2 Microprocessor (ISA A+ with EMAC).
> +@item
> +Three Two on-chip UARTs.
> +@item
> +Fast Ethernet Controller (FEC)
> +@end itemize
> +
> +The AN5206 emulation includes the following devices:
> +
> +@itemize @minus
> +@item
> +MCF5206 ColdFire V2 Microprocessor.
> +@item
> +Two on-chip UARTs.
> +@end itemize
> +
> +@c man begin OPTIONS
> +
> +The following options are specific to the ColdFire emulation:
> +
> +@table @option
> +
> +@item -semihosting
> +Enable semihosting syscall emulation.
> +
> +On M68K this implements the "ColdFire GDB" interface used by libgloss.
> +
> +Note that this allows guest direct access to the host filesystem,
> +so should only be used with trusted guest OS.
> +
> +@end table
> +
> +@c man end
> +
> diff --git a/docs/system/target-mips.texi b/docs/system/target-mips.texi
> new file mode 100644
> index 00000000000..f722c00912a
> --- /dev/null
> +++ b/docs/system/target-mips.texi
> @@ -0,0 +1,152 @@
> +@node MIPS System emulator
> +@section MIPS System emulator
> +@cindex system emulation (MIPS)
> +
> +@menu
> +* recommendations_cpu_models_MIPS:: Supported CPU model configurations on MIPS hosts
> +* nanoMIPS System emulator ::
> +@end menu
> +
> +Four executables cover simulation of 32 and 64-bit MIPS systems in
> +both endian options, @file{qemu-system-mips}, @file{qemu-system-mipsel}
> +@file{qemu-system-mips64} and @file{qemu-system-mips64el}.
> +Five different machine types are emulated:
> +
> +@itemize @minus
> +@item
> +A generic ISA PC-like machine "mips"
> +@item
> +The MIPS Malta prototype board "malta"
> +@item
> +An ACER Pica "pica61". This machine needs the 64-bit emulator.
> +@item
> +MIPS emulator pseudo board "mipssim"
> +@item
> +A MIPS Magnum R4000 machine "magnum". This machine needs the 64-bit emulator.
> +@end itemize
> +
> +The generic emulation is supported by Debian 'Etch' and is able to
> +install Debian into a virtual disk image. The following devices are
> +emulated:
> +
> +@itemize @minus
> +@item
> +A range of MIPS CPUs, default is the 24Kf
> +@item
> +PC style serial port
> +@item
> +PC style IDE disk
> +@item
> +NE2000 network card
> +@end itemize
> +
> +The Malta emulation supports the following devices:
> +
> +@itemize @minus
> +@item
> +Core board with MIPS 24Kf CPU and Galileo system controller
> +@item
> +PIIX4 PCI/USB/SMbus controller
> +@item
> +The Multi-I/O chip's serial device
> +@item
> +PCI network cards (PCnet32 and others)
> +@item
> +Malta FPGA serial device
> +@item
> +Cirrus (default) or any other PCI VGA graphics card
> +@end itemize
> +
> +The Boston board emulation supports the following devices:
> +
> +@itemize @minus
> +@item
> +Xilinx FPGA, which includes a PCIe root port and an UART
> +@item
> +Intel EG20T PCH connects the I/O peripherals, but only the SATA bus is emulated
> +@end itemize
> +
> +The ACER Pica emulation supports:
> +
> +@itemize @minus
> +@item
> +MIPS R4000 CPU
> +@item
> +PC-style IRQ and DMA controllers
> +@item
> +PC Keyboard
> +@item
> +IDE controller
> +@end itemize
> +
> +The MIPS Magnum R4000 emulation supports:
> +
> +@itemize @minus
> +@item
> +MIPS R4000 CPU
> +@item
> +PC-style IRQ controller
> +@item
> +PC Keyboard
> +@item
> +SCSI controller
> +@item
> +G364 framebuffer
> +@end itemize
> +
> +The Fulong 2E emulation supports:
> +
> +@itemize @minus
> +@item
> +Loongson 2E CPU
> +@item
> +Bonito64 system controller as North Bridge
> +@item
> +VT82C686 chipset as South Bridge
> +@item
> +RTL8139D as a network card chipset
> +@end itemize
> +
> +The mipssim pseudo board emulation provides an environment similar
> +to what the proprietary MIPS emulator uses for running Linux.
> +It supports:
> +
> +@itemize @minus
> +@item
> +A range of MIPS CPUs, default is the 24Kf
> +@item
> +PC style serial port
> +@item
> +MIPSnet network emulation
> +@end itemize
> +
> +@lowersections
> +@include docs/system/cpu-models-mips.texi
> +@raisesections
> +
> +@node nanoMIPS System emulator
> +@subsection nanoMIPS System emulator
> +@cindex system emulation (nanoMIPS)
> +
> +Executable @file{qemu-system-mipsel} also covers simulation of
> +32-bit nanoMIPS system in little endian mode:
> +
> +@itemize @minus
> +@item
> +nanoMIPS I7200 CPU
> +@end itemize
> +
> +Example of @file{qemu-system-mipsel} usage for nanoMIPS is shown below:
> +
> +Download @code{<disk_image_file>} from @url{https://mipsdistros.mips.com/LinuxDistro/nanomips/buildroot/index.html}.
> +
> +Download @code{<kernel_image_file>} from @url{https://mipsdistros.mips.com/LinuxDistro/nanomips/kernels/v4.15.18-432-gb2eb9a8b07a1-20180627102142/index.html}.
> +
> +Start system emulation of Malta board with nanoMIPS I7200 CPU:
> +@example
> +qemu-system-mipsel -cpu I7200 -kernel @code{<kernel_image_file>} \
> +    -M malta -serial stdio -m @code{<memory_size>} -hda @code{<disk_image_file>} \
> +    -append "mem=256m@@0x0 rw console=ttyS0 vga=cirrus vesa=0x111 root=/dev/sda"
> +@end example
> +
> +
> diff --git a/docs/system/target-ppc.texi b/docs/system/target-ppc.texi
> new file mode 100644
> index 00000000000..c2c254d3d23
> --- /dev/null
> +++ b/docs/system/target-ppc.texi
> @@ -0,0 +1,78 @@
> +@node PowerPC System emulator
> +@section PowerPC System emulator
> +@cindex system emulation (PowerPC)
> +
> +Use the executable @file{qemu-system-ppc} to simulate a complete 40P (PREP)
> +or PowerMac PowerPC system.
> +
> +QEMU emulates the following PowerMac peripherals:
> +
> +@itemize @minus
> +@item
> +UniNorth or Grackle PCI Bridge
> +@item
> +PCI VGA compatible card with VESA Bochs Extensions
> +@item
> +2 PMAC IDE interfaces with hard disk and CD-ROM support
> +@item
> +NE2000 PCI adapters
> +@item
> +Non Volatile RAM
> +@item
> +VIA-CUDA with ADB keyboard and mouse.
> +@end itemize
> +
> +QEMU emulates the following 40P (PREP) peripherals:
> +
> +@itemize @minus
> +@item
> +PCI Bridge
> +@item
> +PCI VGA compatible card with VESA Bochs Extensions
> +@item
> +2 IDE interfaces with hard disk and CD-ROM support
> +@item
> +Floppy disk
> +@item
> +PCnet network adapters
> +@item
> +Serial port
> +@item
> +PREP Non Volatile RAM
> +@item
> +PC compatible keyboard and mouse.
> +@end itemize
> +
> +Since version 0.9.1, QEMU uses OpenBIOS @url{https://www.openbios.org/}
> +for the g3beige and mac99 PowerMac and the 40p machines. OpenBIOS is a free
> +(GPL v2) portable firmware implementation. The goal is to implement a 100%
> +IEEE 1275-1994 (referred to as Open Firmware) compliant firmware.
> +
> +@c man begin OPTIONS
> +
> +The following options are specific to the PowerPC emulation:
> +
> +@table @option
> +
> +@item -g @var{W}x@var{H}[x@var{DEPTH}]
> +
> +Set the initial VGA graphic mode. The default is 800x600x32.
> +
> +@item -prom-env @var{string}
> +
> +Set OpenBIOS variables in NVRAM, for example:
> +
> +@example
> +qemu-system-ppc -prom-env 'auto-boot?=false' \
> + -prom-env 'boot-device=hd:2,\yaboot' \
> + -prom-env 'boot-args=conf=hd:2,\yaboot.conf'
> +@end example
> +
> +@end table
> +
> +@c man end
> +
> +
> +More information is available at
> +@url{http://perso.magic.fr/l_indien/qemu-ppc/}.
> +
> diff --git a/docs/system/target-sparc.texi b/docs/system/target-sparc.texi
> new file mode 100644
> index 00000000000..7fe0aec9c39
> --- /dev/null
> +++ b/docs/system/target-sparc.texi
> @@ -0,0 +1,96 @@
> +@node Sparc32 System emulator
> +@section Sparc32 System emulator
> +@cindex system emulation (Sparc32)
> +
> +Use the executable @file{qemu-system-sparc} to simulate the following
> +Sun4m architecture machines:
> +@itemize @minus
> +@item
> +SPARCstation 4
> +@item
> +SPARCstation 5
> +@item
> +SPARCstation 10
> +@item
> +SPARCstation 20
> +@item
> +SPARCserver 600MP
> +@item
> +SPARCstation LX
> +@item
> +SPARCstation Voyager
> +@item
> +SPARCclassic
> +@item
> +SPARCbook
> +@end itemize
> +
> +The emulation is somewhat complete. SMP up to 16 CPUs is supported,
> +but Linux limits the number of usable CPUs to 4.
> +
> +QEMU emulates the following sun4m peripherals:
> +
> +@itemize @minus
> +@item
> +IOMMU
> +@item
> +TCX or cgthree Frame buffer
> +@item
> +Lance (Am7990) Ethernet
> +@item
> +Non Volatile RAM M48T02/M48T08
> +@item
> +Slave I/O: timers, interrupt controllers, Zilog serial ports, keyboard
> +and power/reset logic
> +@item
> +ESP SCSI controller with hard disk and CD-ROM support
> +@item
> +Floppy drive (not on SS-600MP)
> +@item
> +CS4231 sound device (only on SS-5, not working yet)
> +@end itemize
> +
> +The number of peripherals is fixed in the architecture.  Maximum
> +memory size depends on the machine type, for SS-5 it is 256MB and for
> +others 2047MB.
> +
> +Since version 0.8.2, QEMU uses OpenBIOS
> +@url{https://www.openbios.org/}. OpenBIOS is a free (GPL v2) portable
> +firmware implementation. The goal is to implement a 100% IEEE
> +1275-1994 (referred to as Open Firmware) compliant firmware.
> +
> +A sample Linux 2.6 series kernel and ram disk image are available on
> +the QEMU web site. There are still issues with NetBSD and OpenBSD, but
> +most kernel versions work. Please note that currently older Solaris kernels
> +don't work probably due to interface issues between OpenBIOS and
> +Solaris.
> +
> +@c man begin OPTIONS
> +
> +The following options are specific to the Sparc32 emulation:
> +
> +@table @option
> +
> +@item -g @var{W}x@var{H}x[x@var{DEPTH}]
> +
> +Set the initial graphics mode. For TCX, the default is 1024x768x8 with the
> +option of 1024x768x24. For cgthree, the default is 1024x768x8 with the option
> +of 1152x900x8 for people who wish to use OBP.
> +
> +@item -prom-env @var{string}
> +
> +Set OpenBIOS variables in NVRAM, for example:
> +
> +@example
> +qemu-system-sparc -prom-env 'auto-boot?=false' \
> + -prom-env 'boot-device=sd(0,2,0):d' -prom-env 'boot-args=linux single'
> +@end example
> +
> +@item -M [SS-4|SS-5|SS-10|SS-20|SS-600MP|LX|Voyager|SPARCClassic] [|SPARCbook]
> +
> +Set the emulated machine type. Default is SS-5.
> +
> +@end table
> +
> +@c man end
> +
> diff --git a/docs/system/target-sparc64.texi b/docs/system/target-sparc64.texi
> new file mode 100644
> index 00000000000..9e7a27de0ce
> --- /dev/null
> +++ b/docs/system/target-sparc64.texi
> @@ -0,0 +1,61 @@
> +@node Sparc64 System emulator
> +@section Sparc64 System emulator
> +@cindex system emulation (Sparc64)
> +
> +Use the executable @file{qemu-system-sparc64} to simulate a Sun4u
> +(UltraSPARC PC-like machine), Sun4v (T1 PC-like machine), or generic
> +Niagara (T1) machine. The Sun4u emulator is mostly complete, being
> +able to run Linux, NetBSD and OpenBSD in headless (-nographic) mode. The
> +Sun4v emulator is still a work in progress.
> +
> +The Niagara T1 emulator makes use of firmware and OS binaries supplied in the S10image/ directory
> +of the OpenSPARC T1 project @url{http://download.oracle.com/technetwork/systems/opensparc/OpenSPARCT1_Arch.1.5.tar.bz2}
> +and is able to boot the disk.s10hw2 Solaris image.
> +@example
> +qemu-system-sparc64 -M niagara -L /path-to/S10image/ \
> +                    -nographic -m 256 \
> +                    -drive if=pflash,readonly=on,file=/S10image/disk.s10hw2
> +@end example
> +
> +
> +QEMU emulates the following peripherals:
> +
> +@itemize @minus
> +@item
> +UltraSparc IIi APB PCI Bridge
> +@item
> +PCI VGA compatible card with VESA Bochs Extensions
> +@item
> +PS/2 mouse and keyboard
> +@item
> +Non Volatile RAM M48T59
> +@item
> +PC-compatible serial ports
> +@item
> +2 PCI IDE interfaces with hard disk and CD-ROM support
> +@item
> +Floppy disk
> +@end itemize
> +
> +@c man begin OPTIONS
> +
> +The following options are specific to the Sparc64 emulation:
> +
> +@table @option
> +
> +@item -prom-env @var{string}
> +
> +Set OpenBIOS variables in NVRAM, for example:
> +
> +@example
> +qemu-system-sparc64 -prom-env 'auto-boot?=false'
> +@end example
> +
> +@item -M [sun4u|sun4v|niagara]
> +
> +Set the emulated machine type. The default is sun4u.
> +
> +@end table
> +
> +@c man end
> +
> diff --git a/docs/system/target-xtensa.texi b/docs/system/target-xtensa.texi
> new file mode 100644
> index 00000000000..08b0b362991
> --- /dev/null
> +++ b/docs/system/target-xtensa.texi
> @@ -0,0 +1,56 @@
> +@node Xtensa System emulator
> +@section Xtensa System emulator
> +@cindex system emulation (Xtensa)
> +
> +Two executables cover simulation of both Xtensa endian options,
> +@file{qemu-system-xtensa} and @file{qemu-system-xtensaeb}.
> +Two different machine types are emulated:
> +
> +@itemize @minus
> +@item
> +Xtensa emulator pseudo board "sim"
> +@item
> +Avnet LX60/LX110/LX200 board
> +@end itemize
> +
> +The sim pseudo board emulation provides an environment similar
> +to one provided by the proprietary Tensilica ISS.
> +It supports:
> +
> +@itemize @minus
> +@item
> +A range of Xtensa CPUs, default is the DC232B
> +@item
> +Console and filesystem access via semihosting calls
> +@end itemize
> +
> +The Avnet LX60/LX110/LX200 emulation supports:
> +
> +@itemize @minus
> +@item
> +A range of Xtensa CPUs, default is the DC232B
> +@item
> +16550 UART
> +@item
> +OpenCores 10/100 Mbps Ethernet MAC
> +@end itemize
> +
> +@c man begin OPTIONS
> +
> +The following options are specific to the Xtensa emulation:
> +
> +@table @option
> +
> +@item -semihosting
> +Enable semihosting syscall emulation.
> +
> +Xtensa semihosting provides basic file IO calls, such as open/read/write/seek/select.
> +Tensilica baremetal libc for ISS and linux platform "sim" use this interface.
> +
> +Note that this allows guest direct access to the host filesystem,
> +so should only be used with trusted guest OS.
> +
> +@end table
> +
> +@c man end
> +
> diff --git a/qemu-doc.texi b/qemu-doc.texi
> index 40fab523f35..f702dce4557 100644
> --- a/qemu-doc.texi
> +++ b/qemu-doc.texi
> @@ -176,874 +176,17 @@ various targets are mentioned in the following sections.
>  * MIPS System emulator::
>  * ARM System emulator::
>  * ColdFire System emulator::
> -* Cris System emulator::
> -* Microblaze System emulator::
> -* SH4 System emulator::
>  * Xtensa System emulator::
>  @end menu
>  
> -@node x86 (PC) System emulator
> -@section x86 (PC) System emulator
> -@cindex system emulation (PC)
> -
> -@menu
> -* pcsys_devices::      Peripherals
> -* cpu_models_x86::     Supported CPU model configurations on x86 hosts
> -* pcsys_req::          OS requirements
> -@end menu
> -
> -@node pcsys_devices
> -@subsection Peripherals
> -
> -@c man begin DESCRIPTION
> -
> -The QEMU PC System emulator simulates the following peripherals:
> -
> -@itemize @minus
> -@item
> -i440FX host PCI bridge and PIIX3 PCI to ISA bridge
> -@item
> -Cirrus CLGD 5446 PCI VGA card or dummy VGA card with Bochs VESA
> -extensions (hardware level, including all non standard modes).
> -@item
> -PS/2 mouse and keyboard
> -@item
> -2 PCI IDE interfaces with hard disk and CD-ROM support
> -@item
> -Floppy disk
> -@item
> -PCI and ISA network adapters
> -@item
> -Serial ports
> -@item
> -IPMI BMC, either and internal or external one
> -@item
> -Creative SoundBlaster 16 sound card
> -@item
> -ENSONIQ AudioPCI ES1370 sound card
> -@item
> -Intel 82801AA AC97 Audio compatible sound card
> -@item
> -Intel HD Audio Controller and HDA codec
> -@item
> -Adlib (OPL2) - Yamaha YM3812 compatible chip
> -@item
> -Gravis Ultrasound GF1 sound card
> -@item
> -CS4231A compatible sound card
> -@item
> -PCI UHCI, OHCI, EHCI or XHCI USB controller and a virtual USB-1.1 hub.
> -@end itemize
> -
> -SMP is supported with up to 255 CPUs.
> -
> -QEMU uses the PC BIOS from the Seabios project and the Plex86/Bochs LGPL
> -VGA BIOS.
> -
> -QEMU uses YM3812 emulation by Tatsuyuki Satoh.
> -
> -QEMU uses GUS emulation (GUSEMU32 @url{http://www.deinmeister.de/gusemu/})
> -by Tibor "TS" Schütz.
> -
> -Note that, by default, GUS shares IRQ(7) with parallel ports and so
> -QEMU must be told to not have parallel ports to have working GUS.
> -
> -@example
> -@value{qemu_system_x86} dos.img -soundhw gus -parallel none
> -@end example
> -
> -Alternatively:
> -@example
> -@value{qemu_system_x86} dos.img -device gus,irq=5
> -@end example
> -
> -Or some other unclaimed IRQ.
> -
> -CS4231A is the chip used in Windows Sound System and GUSMAX products
> -
> -@c man end
> -
> -@lowersections
> -@include docs/system/cpu-models-x86.texi
> -@raisesections
> -
> -@node pcsys_req
> -@subsection OS requirements
> -
> -On x86_64 hosts, the default set of CPU features enabled by the KVM accelerator
> -require the host to be running Linux v4.5 or newer.  Red Hat Enterprise Linux
> -7 is also supported, since the required functionality was backported.
> -
> -@node PowerPC System emulator
> -@section PowerPC System emulator
> -@cindex system emulation (PowerPC)
> -
> -Use the executable @file{qemu-system-ppc} to simulate a complete 40P (PREP)
> -or PowerMac PowerPC system.
> -
> -QEMU emulates the following PowerMac peripherals:
> -
> -@itemize @minus
> -@item
> -UniNorth or Grackle PCI Bridge
> -@item
> -PCI VGA compatible card with VESA Bochs Extensions
> -@item
> -2 PMAC IDE interfaces with hard disk and CD-ROM support
> -@item
> -NE2000 PCI adapters
> -@item
> -Non Volatile RAM
> -@item
> -VIA-CUDA with ADB keyboard and mouse.
> -@end itemize
> -
> -QEMU emulates the following 40P (PREP) peripherals:
> -
> -@itemize @minus
> -@item
> -PCI Bridge
> -@item
> -PCI VGA compatible card with VESA Bochs Extensions
> -@item
> -2 IDE interfaces with hard disk and CD-ROM support
> -@item
> -Floppy disk
> -@item
> -PCnet network adapters
> -@item
> -Serial port
> -@item
> -PREP Non Volatile RAM
> -@item
> -PC compatible keyboard and mouse.
> -@end itemize
> -
> -Since version 0.9.1, QEMU uses OpenBIOS @url{https://www.openbios.org/}
> -for the g3beige and mac99 PowerMac and the 40p machines. OpenBIOS is a free
> -(GPL v2) portable firmware implementation. The goal is to implement a 100%
> -IEEE 1275-1994 (referred to as Open Firmware) compliant firmware.
> -
> -@c man begin OPTIONS
> -
> -The following options are specific to the PowerPC emulation:
> -
> -@table @option
> -
> -@item -g @var{W}x@var{H}[x@var{DEPTH}]
> -
> -Set the initial VGA graphic mode. The default is 800x600x32.
> -
> -@item -prom-env @var{string}
> -
> -Set OpenBIOS variables in NVRAM, for example:
> -
> -@example
> -qemu-system-ppc -prom-env 'auto-boot?=false' \
> - -prom-env 'boot-device=hd:2,\yaboot' \
> - -prom-env 'boot-args=conf=hd:2,\yaboot.conf'
> -@end example
> -
> -@end table
> -
> -@c man end
> -
> -
> -More information is available at
> -@url{http://perso.magic.fr/l_indien/qemu-ppc/}.
> -
> -@node Sparc32 System emulator
> -@section Sparc32 System emulator
> -@cindex system emulation (Sparc32)
> -
> -Use the executable @file{qemu-system-sparc} to simulate the following
> -Sun4m architecture machines:
> -@itemize @minus
> -@item
> -SPARCstation 4
> -@item
> -SPARCstation 5
> -@item
> -SPARCstation 10
> -@item
> -SPARCstation 20
> -@item
> -SPARCserver 600MP
> -@item
> -SPARCstation LX
> -@item
> -SPARCstation Voyager
> -@item
> -SPARCclassic
> -@item
> -SPARCbook
> -@end itemize
> -
> -The emulation is somewhat complete. SMP up to 16 CPUs is supported,
> -but Linux limits the number of usable CPUs to 4.
> -
> -QEMU emulates the following sun4m peripherals:
> -
> -@itemize @minus
> -@item
> -IOMMU
> -@item
> -TCX or cgthree Frame buffer
> -@item
> -Lance (Am7990) Ethernet
> -@item
> -Non Volatile RAM M48T02/M48T08
> -@item
> -Slave I/O: timers, interrupt controllers, Zilog serial ports, keyboard
> -and power/reset logic
> -@item
> -ESP SCSI controller with hard disk and CD-ROM support
> -@item
> -Floppy drive (not on SS-600MP)
> -@item
> -CS4231 sound device (only on SS-5, not working yet)
> -@end itemize
> -
> -The number of peripherals is fixed in the architecture.  Maximum
> -memory size depends on the machine type, for SS-5 it is 256MB and for
> -others 2047MB.
> -
> -Since version 0.8.2, QEMU uses OpenBIOS
> -@url{https://www.openbios.org/}. OpenBIOS is a free (GPL v2) portable
> -firmware implementation. The goal is to implement a 100% IEEE
> -1275-1994 (referred to as Open Firmware) compliant firmware.
> -
> -A sample Linux 2.6 series kernel and ram disk image are available on
> -the QEMU web site. There are still issues with NetBSD and OpenBSD, but
> -most kernel versions work. Please note that currently older Solaris kernels
> -don't work probably due to interface issues between OpenBIOS and
> -Solaris.
> -
> -@c man begin OPTIONS
> -
> -The following options are specific to the Sparc32 emulation:
> -
> -@table @option
> -
> -@item -g @var{W}x@var{H}x[x@var{DEPTH}]
> -
> -Set the initial graphics mode. For TCX, the default is 1024x768x8 with the
> -option of 1024x768x24. For cgthree, the default is 1024x768x8 with the option
> -of 1152x900x8 for people who wish to use OBP.
> -
> -@item -prom-env @var{string}
> -
> -Set OpenBIOS variables in NVRAM, for example:
> -
> -@example
> -qemu-system-sparc -prom-env 'auto-boot?=false' \
> - -prom-env 'boot-device=sd(0,2,0):d' -prom-env 'boot-args=linux single'
> -@end example
> -
> -@item -M [SS-4|SS-5|SS-10|SS-20|SS-600MP|LX|Voyager|SPARCClassic] [|SPARCbook]
> -
> -Set the emulated machine type. Default is SS-5.
> -
> -@end table
> -
> -@c man end
> -
> -@node Sparc64 System emulator
> -@section Sparc64 System emulator
> -@cindex system emulation (Sparc64)
> -
> -Use the executable @file{qemu-system-sparc64} to simulate a Sun4u
> -(UltraSPARC PC-like machine), Sun4v (T1 PC-like machine), or generic
> -Niagara (T1) machine. The Sun4u emulator is mostly complete, being
> -able to run Linux, NetBSD and OpenBSD in headless (-nographic) mode. The
> -Sun4v emulator is still a work in progress.
> -
> -The Niagara T1 emulator makes use of firmware and OS binaries supplied in the S10image/ directory
> -of the OpenSPARC T1 project @url{http://download.oracle.com/technetwork/systems/opensparc/OpenSPARCT1_Arch.1.5.tar.bz2}
> -and is able to boot the disk.s10hw2 Solaris image.
> -@example
> -qemu-system-sparc64 -M niagara -L /path-to/S10image/ \
> -                    -nographic -m 256 \
> -                    -drive if=pflash,readonly=on,file=/S10image/disk.s10hw2
> -@end example
> -
> -
> -QEMU emulates the following peripherals:
> -
> -@itemize @minus
> -@item
> -UltraSparc IIi APB PCI Bridge
> -@item
> -PCI VGA compatible card with VESA Bochs Extensions
> -@item
> -PS/2 mouse and keyboard
> -@item
> -Non Volatile RAM M48T59
> -@item
> -PC-compatible serial ports
> -@item
> -2 PCI IDE interfaces with hard disk and CD-ROM support
> -@item
> -Floppy disk
> -@end itemize
> -
> -@c man begin OPTIONS
> -
> -The following options are specific to the Sparc64 emulation:
> -
> -@table @option
> -
> -@item -prom-env @var{string}
> -
> -Set OpenBIOS variables in NVRAM, for example:
> -
> -@example
> -qemu-system-sparc64 -prom-env 'auto-boot?=false'
> -@end example
> -
> -@item -M [sun4u|sun4v|niagara]
> -
> -Set the emulated machine type. The default is sun4u.
> -
> -@end table
> -
> -@c man end
> -
> -@node MIPS System emulator
> -@section MIPS System emulator
> -@cindex system emulation (MIPS)
> -
> -@menu
> -* recommendations_cpu_models_MIPS:: Supported CPU model configurations on MIPS hosts
> -* nanoMIPS System emulator ::
> -@end menu
> -
> -Four executables cover simulation of 32 and 64-bit MIPS systems in
> -both endian options, @file{qemu-system-mips}, @file{qemu-system-mipsel}
> -@file{qemu-system-mips64} and @file{qemu-system-mips64el}.
> -Five different machine types are emulated:
> -
> -@itemize @minus
> -@item
> -A generic ISA PC-like machine "mips"
> -@item
> -The MIPS Malta prototype board "malta"
> -@item
> -An ACER Pica "pica61". This machine needs the 64-bit emulator.
> -@item
> -MIPS emulator pseudo board "mipssim"
> -@item
> -A MIPS Magnum R4000 machine "magnum". This machine needs the 64-bit emulator.
> -@end itemize
> -
> -The generic emulation is supported by Debian 'Etch' and is able to
> -install Debian into a virtual disk image. The following devices are
> -emulated:
> -
> -@itemize @minus
> -@item
> -A range of MIPS CPUs, default is the 24Kf
> -@item
> -PC style serial port
> -@item
> -PC style IDE disk
> -@item
> -NE2000 network card
> -@end itemize
> -
> -The Malta emulation supports the following devices:
> -
> -@itemize @minus
> -@item
> -Core board with MIPS 24Kf CPU and Galileo system controller
> -@item
> -PIIX4 PCI/USB/SMbus controller
> -@item
> -The Multi-I/O chip's serial device
> -@item
> -PCI network cards (PCnet32 and others)
> -@item
> -Malta FPGA serial device
> -@item
> -Cirrus (default) or any other PCI VGA graphics card
> -@end itemize
> -
> -The Boston board emulation supports the following devices:
> -
> -@itemize @minus
> -@item
> -Xilinx FPGA, which includes a PCIe root port and an UART
> -@item
> -Intel EG20T PCH connects the I/O peripherals, but only the SATA bus is emulated
> -@end itemize
> -
> -The ACER Pica emulation supports:
> -
> -@itemize @minus
> -@item
> -MIPS R4000 CPU
> -@item
> -PC-style IRQ and DMA controllers
> -@item
> -PC Keyboard
> -@item
> -IDE controller
> -@end itemize
> -
> -The MIPS Magnum R4000 emulation supports:
> -
> -@itemize @minus
> -@item
> -MIPS R4000 CPU
> -@item
> -PC-style IRQ controller
> -@item
> -PC Keyboard
> -@item
> -SCSI controller
> -@item
> -G364 framebuffer
> -@end itemize
> -
> -The Fulong 2E emulation supports:
> -
> -@itemize @minus
> -@item
> -Loongson 2E CPU
> -@item
> -Bonito64 system controller as North Bridge
> -@item
> -VT82C686 chipset as South Bridge
> -@item
> -RTL8139D as a network card chipset
> -@end itemize
> -
> -The mipssim pseudo board emulation provides an environment similar
> -to what the proprietary MIPS emulator uses for running Linux.
> -It supports:
> -
> -@itemize @minus
> -@item
> -A range of MIPS CPUs, default is the 24Kf
> -@item
> -PC style serial port
> -@item
> -MIPSnet network emulation
> -@end itemize
> -
> -@lowersections
> -@include docs/system/cpu-models-mips.texi
> -@raisesections
> -
> -@node nanoMIPS System emulator
> -@subsection nanoMIPS System emulator
> -@cindex system emulation (nanoMIPS)
> -
> -Executable @file{qemu-system-mipsel} also covers simulation of
> -32-bit nanoMIPS system in little endian mode:
> -
> -@itemize @minus
> -@item
> -nanoMIPS I7200 CPU
> -@end itemize
> -
> -Example of @file{qemu-system-mipsel} usage for nanoMIPS is shown below:
> -
> -Download @code{<disk_image_file>} from @url{https://mipsdistros.mips.com/LinuxDistro/nanomips/buildroot/index.html}.
> -
> -Download @code{<kernel_image_file>} from @url{https://mipsdistros.mips.com/LinuxDistro/nanomips/kernels/v4.15.18-432-gb2eb9a8b07a1-20180627102142/index.html}.
> -
> -Start system emulation of Malta board with nanoMIPS I7200 CPU:
> -@example
> -qemu-system-mipsel -cpu I7200 -kernel @code{<kernel_image_file>} \
> -    -M malta -serial stdio -m @code{<memory_size>} -hda @code{<disk_image_file>} \
> -    -append "mem=256m@@0x0 rw console=ttyS0 vga=cirrus vesa=0x111 root=/dev/sda"
> -@end example
> -
> -
> -@node ARM System emulator
> -@section ARM System emulator
> -@cindex system emulation (ARM)
> -
> -Use the executable @file{qemu-system-arm} to simulate a ARM
> -machine. The ARM Integrator/CP board is emulated with the following
> -devices:
> -
> -@itemize @minus
> -@item
> -ARM926E, ARM1026E, ARM946E, ARM1136 or Cortex-A8 CPU
> -@item
> -Two PL011 UARTs
> -@item
> -SMC 91c111 Ethernet adapter
> -@item
> -PL110 LCD controller
> -@item
> -PL050 KMI with PS/2 keyboard and mouse.
> -@item
> -PL181 MultiMedia Card Interface with SD card.
> -@end itemize
> -
> -The ARM Versatile baseboard is emulated with the following devices:
> -
> -@itemize @minus
> -@item
> -ARM926E, ARM1136 or Cortex-A8 CPU
> -@item
> -PL190 Vectored Interrupt Controller
> -@item
> -Four PL011 UARTs
> -@item
> -SMC 91c111 Ethernet adapter
> -@item
> -PL110 LCD controller
> -@item
> -PL050 KMI with PS/2 keyboard and mouse.
> -@item
> -PCI host bridge.  Note the emulated PCI bridge only provides access to
> -PCI memory space.  It does not provide access to PCI IO space.
> -This means some devices (eg. ne2k_pci NIC) are not usable, and others
> -(eg. rtl8139 NIC) are only usable when the guest drivers use the memory
> -mapped control registers.
> -@item
> -PCI OHCI USB controller.
> -@item
> -LSI53C895A PCI SCSI Host Bus Adapter with hard disk and CD-ROM devices.
> -@item
> -PL181 MultiMedia Card Interface with SD card.
> -@end itemize
> -
> -Several variants of the ARM RealView baseboard are emulated,
> -including the EB, PB-A8 and PBX-A9.  Due to interactions with the
> -bootloader, only certain Linux kernel configurations work out
> -of the box on these boards.
> -
> -Kernels for the PB-A8 board should have CONFIG_REALVIEW_HIGH_PHYS_OFFSET
> -enabled in the kernel, and expect 512M RAM.  Kernels for The PBX-A9 board
> -should have CONFIG_SPARSEMEM enabled, CONFIG_REALVIEW_HIGH_PHYS_OFFSET
> -disabled and expect 1024M RAM.
> -
> -The following devices are emulated:
> -
> -@itemize @minus
> -@item
> -ARM926E, ARM1136, ARM11MPCore, Cortex-A8 or Cortex-A9 MPCore CPU
> -@item
> -ARM AMBA Generic/Distributed Interrupt Controller
> -@item
> -Four PL011 UARTs
> -@item
> -SMC 91c111 or SMSC LAN9118 Ethernet adapter
> -@item
> -PL110 LCD controller
> -@item
> -PL050 KMI with PS/2 keyboard and mouse
> -@item
> -PCI host bridge
> -@item
> -PCI OHCI USB controller
> -@item
> -LSI53C895A PCI SCSI Host Bus Adapter with hard disk and CD-ROM devices
> -@item
> -PL181 MultiMedia Card Interface with SD card.
> -@end itemize
> -
> -The XScale-based clamshell PDA models ("Spitz", "Akita", "Borzoi"
> -and "Terrier") emulation includes the following peripherals:
> -
> -@itemize @minus
> -@item
> -Intel PXA270 System-on-chip (ARM V5TE core)
> -@item
> -NAND Flash memory
> -@item
> -IBM/Hitachi DSCM microdrive in a PXA PCMCIA slot - not in "Akita"
> -@item
> -On-chip OHCI USB controller
> -@item
> -On-chip LCD controller
> -@item
> -On-chip Real Time Clock
> -@item
> -TI ADS7846 touchscreen controller on SSP bus
> -@item
> -Maxim MAX1111 analog-digital converter on I@math{^2}C bus
> -@item
> -GPIO-connected keyboard controller and LEDs
> -@item
> -Secure Digital card connected to PXA MMC/SD host
> -@item
> -Three on-chip UARTs
> -@item
> -WM8750 audio CODEC on I@math{^2}C and I@math{^2}S busses
> -@end itemize
> -
> -The Palm Tungsten|E PDA (codename "Cheetah") emulation includes the
> -following elements:
> -
> -@itemize @minus
> -@item
> -Texas Instruments OMAP310 System-on-chip (ARM 925T core)
> -@item
> -ROM and RAM memories (ROM firmware image can be loaded with -option-rom)
> -@item
> -On-chip LCD controller
> -@item
> -On-chip Real Time Clock
> -@item
> -TI TSC2102i touchscreen controller / analog-digital converter / Audio
> -CODEC, connected through MicroWire and I@math{^2}S busses
> -@item
> -GPIO-connected matrix keypad
> -@item
> -Secure Digital card connected to OMAP MMC/SD host
> -@item
> -Three on-chip UARTs
> -@end itemize
> -
> -Nokia N800 and N810 internet tablets (known also as RX-34 and RX-44 / 48)
> -emulation supports the following elements:
> -
> -@itemize @minus
> -@item
> -Texas Instruments OMAP2420 System-on-chip (ARM 1136 core)
> -@item
> -RAM and non-volatile OneNAND Flash memories
> -@item
> -Display connected to EPSON remote framebuffer chip and OMAP on-chip
> -display controller and a LS041y3 MIPI DBI-C controller
> -@item
> -TI TSC2301 (in N800) and TI TSC2005 (in N810) touchscreen controllers
> -driven through SPI bus
> -@item
> -National Semiconductor LM8323-controlled qwerty keyboard driven
> -through I@math{^2}C bus
> -@item
> -Secure Digital card connected to OMAP MMC/SD host
> -@item
> -Three OMAP on-chip UARTs and on-chip STI debugging console
> -@item
> -Mentor Graphics "Inventra" dual-role USB controller embedded in a TI
> -TUSB6010 chip - only USB host mode is supported
> -@item
> -TI TMP105 temperature sensor driven through I@math{^2}C bus
> -@item
> -TI TWL92230C power management companion with an RTC on I@math{^2}C bus
> -@item
> -Nokia RETU and TAHVO multi-purpose chips with an RTC, connected
> -through CBUS
> -@end itemize
> -
> -The Luminary Micro Stellaris LM3S811EVB emulation includes the following
> -devices:
> -
> -@itemize @minus
> -@item
> -Cortex-M3 CPU core.
> -@item
> -64k Flash and 8k SRAM.
> -@item
> -Timers, UARTs, ADC and I@math{^2}C interface.
> -@item
> -OSRAM Pictiva 96x16 OLED with SSD0303 controller on I@math{^2}C bus.
> -@end itemize
> -
> -The Luminary Micro Stellaris LM3S6965EVB emulation includes the following
> -devices:
> -
> -@itemize @minus
> -@item
> -Cortex-M3 CPU core.
> -@item
> -256k Flash and 64k SRAM.
> -@item
> -Timers, UARTs, ADC, I@math{^2}C and SSI interfaces.
> -@item
> -OSRAM Pictiva 128x64 OLED with SSD0323 controller connected via SSI.
> -@end itemize
> -
> -The Freecom MusicPal internet radio emulation includes the following
> -elements:
> -
> -@itemize @minus
> -@item
> -Marvell MV88W8618 ARM core.
> -@item
> -32 MB RAM, 256 KB SRAM, 8 MB flash.
> -@item
> -Up to 2 16550 UARTs
> -@item
> -MV88W8xx8 Ethernet controller
> -@item
> -MV88W8618 audio controller, WM8750 CODEC and mixer
> -@item
> -128×64 display with brightness control
> -@item
> -2 buttons, 2 navigation wheels with button function
> -@end itemize
> -
> -The Siemens SX1 models v1 and v2 (default) basic emulation.
> -The emulation includes the following elements:
> -
> -@itemize @minus
> -@item
> -Texas Instruments OMAP310 System-on-chip (ARM 925T core)
> -@item
> -ROM and RAM memories (ROM firmware image can be loaded with -pflash)
> -V1
> -1 Flash of 16MB and 1 Flash of 8MB
> -V2
> -1 Flash of 32MB
> -@item
> -On-chip LCD controller
> -@item
> -On-chip Real Time Clock
> -@item
> -Secure Digital card connected to OMAP MMC/SD host
> -@item
> -Three on-chip UARTs
> -@end itemize
> -
> -A Linux 2.6 test image is available on the QEMU web site. More
> -information is available in the QEMU mailing-list archive.
> -
> -@c man begin OPTIONS
> -
> -The following options are specific to the ARM emulation:
> -
> -@table @option
> -
> -@item -semihosting
> -Enable semihosting syscall emulation.
> -
> -On ARM this implements the "Angel" interface.
> -
> -Note that this allows guest direct access to the host filesystem,
> -so should only be used with trusted guest OS.
> -
> -@end table
> -
> -@c man end
> -
> -@node ColdFire System emulator
> -@section ColdFire System emulator
> -@cindex system emulation (ColdFire)
> -@cindex system emulation (M68K)
> -
> -Use the executable @file{qemu-system-m68k} to simulate a ColdFire machine.
> -The emulator is able to boot a uClinux kernel.
> -
> -The M5208EVB emulation includes the following devices:
> -
> -@itemize @minus
> -@item
> -MCF5208 ColdFire V2 Microprocessor (ISA A+ with EMAC).
> -@item
> -Three Two on-chip UARTs.
> -@item
> -Fast Ethernet Controller (FEC)
> -@end itemize
> -
> -The AN5206 emulation includes the following devices:
> -
> -@itemize @minus
> -@item
> -MCF5206 ColdFire V2 Microprocessor.
> -@item
> -Two on-chip UARTs.
> -@end itemize
> -
> -@c man begin OPTIONS
> -
> -The following options are specific to the ColdFire emulation:
> -
> -@table @option
> -
> -@item -semihosting
> -Enable semihosting syscall emulation.
> -
> -On M68K this implements the "ColdFire GDB" interface used by libgloss.
> -
> -Note that this allows guest direct access to the host filesystem,
> -so should only be used with trusted guest OS.
> -
> -@end table
> -
> -@c man end
> -
> -@node Cris System emulator
> -@section Cris System emulator
> -@cindex system emulation (Cris)
> -
> -TODO
> -
> -@node Microblaze System emulator
> -@section Microblaze System emulator
> -@cindex system emulation (Microblaze)
> -
> -TODO
> -
> -@node SH4 System emulator
> -@section SH4 System emulator
> -@cindex system emulation (SH4)
> -
> -TODO
> -
> -@node Xtensa System emulator
> -@section Xtensa System emulator
> -@cindex system emulation (Xtensa)
> -
> -Two executables cover simulation of both Xtensa endian options,
> -@file{qemu-system-xtensa} and @file{qemu-system-xtensaeb}.
> -Two different machine types are emulated:
> -
> -@itemize @minus
> -@item
> -Xtensa emulator pseudo board "sim"
> -@item
> -Avnet LX60/LX110/LX200 board
> -@end itemize
> -
> -The sim pseudo board emulation provides an environment similar
> -to one provided by the proprietary Tensilica ISS.
> -It supports:
> -
> -@itemize @minus
> -@item
> -A range of Xtensa CPUs, default is the DC232B
> -@item
> -Console and filesystem access via semihosting calls
> -@end itemize
> -
> -The Avnet LX60/LX110/LX200 emulation supports:
> -
> -@itemize @minus
> -@item
> -A range of Xtensa CPUs, default is the DC232B
> -@item
> -16550 UART
> -@item
> -OpenCores 10/100 Mbps Ethernet MAC
> -@end itemize
> -
> -@c man begin OPTIONS
> -
> -The following options are specific to the Xtensa emulation:
> -
> -@table @option
> -
> -@item -semihosting
> -Enable semihosting syscall emulation.
> -
> -Xtensa semihosting provides basic file IO calls, such as open/read/write/seek/select.
> -Tensilica baremetal libc for ISS and linux platform "sim" use this interface.
> -
> -Note that this allows guest direct access to the host filesystem,
> -so should only be used with trusted guest OS.
> -
> -@end table
> -
> -@c man end
> +@include docs/system/target-i386.texi
> +@include docs/system/target-ppc.texi
> +@include docs/system/target-sparc.texi
> +@include docs/system/target-sparc64.texi
> +@include docs/system/target-mips.texi
> +@include docs/system/target-arm.texi
> +@include docs/system/target-m68k.texi
> +@include docs/system/target-xtensa.texi
>  
>  @include docs/security.texi


-- 
Alex Bennée