Archipelago » qemu

* QEMU System emulator for non PC targets::

* QEMU User space emulator::

* compilation:: Compilation from the sources

* Index::

@end menu

@end ifnottex

QEMU has two operating modes:

@itemize

@item

Full system emulation. In this mode, QEMU emulates a full system (for

example a PC), including one or several processors and various

peripherals. It can be used to launch different Operating Systems

without rebooting the PC or to debug system code.

@item

User mode emulation. In this mode, QEMU can launch

processes compiled for one CPU on another CPU. It can be used to

launch the Wine Windows API emulator (@url{http://www.winehq.org}) or

For system emulation, the following hardware targets are supported:

@itemize

@item PC (x86 or x86_64 processor)

@item ISA PC (old style PC without PCI bus)

@item PREP (PowerPC processor)

@item Petalogix Spartan 3aDSP1800 MMU ref design (MicroBlaze).

@end itemize

@node Installation

@chapter Installation

@node install_linux

@section Linux

If a precompiled package is available for your distribution - you just

have to install it. Otherwise, see @ref{compilation}.

@node install_windows

@section Windows

Download the experimental binary installer at

@url{http://www.free.oszoo.org/@/download.html}.

@node install_mac

@section Mac OS X

Download the experimental binary installer at

@url{http://www.free.oszoo.org/@/download.html}.

@node QEMU PC System emulator

@chapter QEMU PC System emulator

@menu

* pcsys_introduction:: Introduction

@node pcsys_quickstart

@section Quick Start

Download and uncompress the linux image (@file{linux.img}) and type:

During the graphical emulation, you can use the following keys:

@table @key

@item Ctrl-Alt-f

Toggle full screen

@item Ctrl-Alt-u

Restore the screen's un-scaled dimensions

@item Ctrl-Alt-n

Switch to virtual console 'n'. Standard console mappings are:

@table @emph

@item 1

@end table

@item Ctrl-Alt

Toggle mouse and keyboard grab.

@end table

In the virtual consoles, you can use @key{Ctrl-Up}, @key{Ctrl-Down},

@key{Ctrl-PageUp} and @key{Ctrl-PageDown} to move in the back log.

During emulation, if you are using the @option{-nographic} option, use

@key{Ctrl-a h} to get terminal commands:

@table @key

@item Ctrl-a h

@item Ctrl-a ?

Print this help

@item Ctrl-a x

Exit emulator

@item Ctrl-a s

Save disk data back to file (if -snapshot)

@item Ctrl-a t

Toggle console timestamps

@item Ctrl-a b

Send break (magic sysrq in Linux)

@item Ctrl-a c

Switch between console and monitor

@item Ctrl-a Ctrl-a

Send Ctrl-a

@end table

@c man end

@node pcsys_monitor

@section QEMU Monitor

The QEMU monitor is used to give complex commands to the QEMU

emulator. You can use it to:

differences are mentioned in the following sections.

@menu

* Sparc32 System emulator::

* Sparc64 System emulator::

* MIPS System emulator::

* ARM System emulator::

* ColdFire System emulator::

@end menu

Use the executable @file{qemu-system-ppc} to simulate a complete PREP

or PowerMac PowerPC system.

@node Sparc32 System emulator

@section Sparc32 System emulator

Use the executable @file{qemu-system-sparc} to simulate the following

Sun4m architecture machines:

@node Sparc64 System emulator

@section Sparc64 System emulator

Use the executable @file{qemu-system-sparc64} to simulate a Sun4u

(UltraSPARC PC-like machine), Sun4v (T1 PC-like machine), or generic

@node MIPS System emulator

@section MIPS System emulator

Four executables cover simulation of 32 and 64-bit MIPS systems in

both endian options, @file{qemu-system-mips}, @file{qemu-system-mipsel}

@node ARM System emulator

@section ARM System emulator

Use the executable @file{qemu-system-arm} to simulate a ARM

machine. The ARM Integrator/CP board is emulated with the following

@node ColdFire System emulator

@section ColdFire System emulator

Use the executable @file{qemu-system-m68k} to simulate a ColdFire machine.

The emulator is able to boot a uClinux kernel.

@c man begin OPTIONS

@table @option

@end table

@node QEMU User space emulator

@chapter QEMU User space emulator

@node Other binaries

@subsection Other binaries

@command{qemu-arm} is also capable of running ARM "Angel" semihosted ELF

binaries (as implemented by the arm-elf and arm-eabi Newlib/GDB

configurations), and arm-uclinux bFLT format binaries.

@command{qemu-m68k} is capable of running semihosted binaries using the BDM

(m5xxx-ram-hosted.ld) or m68k-sim (sim.ld) syscall interfaces, and

coldfire uClinux bFLT format binaries.

The binary format is detected automatically.

@command{qemu-sparc} can execute Sparc32 binaries (Sparc32 CPU, 32 bit ABI).

@command{qemu-sparc32plus} can execute Sparc32 and SPARC32PLUS binaries

@end table

@node Index

@printindex cp

@bye