Archipelago » qemu

@itemize @minus

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.

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

@end itemize

QEMU can run without an host kernel driver and yet gives acceptable

For system emulation, the following hardware targets are supported:

@itemize

following peripherals:

@itemize @minus

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

2 PCI IDE interfaces with hard disk and CD-ROM support

@item

Floppy disk

PCI/ISA PCI network adapters

@item

Serial ports

@item -net socket[,vlan=n][,fd=h][,mcast=maddr:port]

Create a VLAN @var{n} shared with another QEMU virtual

every QEMU with same multicast address @var{maddr} and @var{port}.

NOTES:

@enumerate

correct multicast setup for these hosts).

@item

mcast support is compatible with User Mode Linux (argument @option{eth@var{N}=mcast}), see

@table @option

Use @var{bzImage} as kernel image.

Use @var{cmdline} as kernel command line

@item -initrd file

@end table

@item -s

@item -p port

Change gdb connection port.  @var{port} can be either a decimal number

to specify a TCP port, or a host device (same devices as the serial port).

@item -S

Do not start CPU at startup (you must type 'c' in the monitor).

Output log in /tmp/qemu.log

@item -hdachs c,h,s,[,t]

Force hard disk 0 physical geometry (1 <= @var{c} <= 16383, 1 <=

@table @key

@item Ctrl-a h

Print this help

Exit emulator

Save disk data back to file (if -snapshot)

@item Ctrl-a t

toggle console timestamps

Remove or insert removable media images

(such as CD-ROM or floppies)

Freeze/unfreeze the Virtual Machine (VM) and save or restore its state

from a disk file.

@item help or ? [cmd]

Show the help for all commands or just for command @var{cmd}.

Commit changes to the disk images (if -snapshot is used)

show various information about the system state

@table @option

data. Its syntax is: @option{/@{count@}@{format@}@{size@}}

@table @var

is the number of items to be dumped.

@item format

@end table

@itemize

@item

Dump 10 instructions at the current instruction pointer:

(qemu) x/10i $eip

0x90107063:  ret

0x90107064:  sti

@item

Dump 80 16 bit values at the start of the video memory.

(qemu) xp/80hx 0xb8000

0x000b8000: 0x0b50 0x0b6c 0x0b65 0x0b78 0x0b38 0x0b36 0x0b2f 0x0b42

0x000b8010: 0x0b6f 0x0b63 0x0b68 0x0b73 0x0b20 0x0b56 0x0b47 0x0b41

VM snapshots currently have the following known limitations:

@itemize

They cannot cope with removable devices if they are removed or

inserted after a snapshot is done.

A few device drivers still have incomplete snapshot support so their

state is not saved or restored properly (in particular USB).

@end itemize

@subsubsection Mac OS X

Currently there is no specific code to handle removable media, so it

is better to use the @code{change} or @code{eject} monitor commands to

QEMU can automatically create a virtual FAT disk image from a

directory tree. In order to use it, just type:

qemu linux.img -hdb fat:/my_directory

@end example

Floppies can be emulated with the @code{:floppy:} option:

qemu linux.img -fda fat:floppy:/my_directory

@end example

A read/write support is available for testing (beta stage) with the

@code{:rw:} option:

qemu linux.img -fda fat:floppy:rw:/my_directory

@end example

                           |          (10.0.2.2)

                           |

                           ---->  DNS server (10.0.2.3)

                           ---->  SMB server (10.0.2.4)

@end example

Cameras) are not supported yet.

@enumerate

is actually using the USB device. A simple way to do that is simply to

disable the corresponding kernel module by renaming it from @file{mydriver.o}

to @file{mydriver.o.disabled}.

@end example

@item Launch QEMU and do in the monitor:

info usbhost

  Device 1.2, speed 480 Mb/s

    Class 00: USB device 1234:5678, USB DISK

hubs, it won't work).

@item Add the device in QEMU by using:

usb_add host:1234:5678

@end example

Add/Troubleshoot a device => Add a new device & Next => No, select the

hardware from a list & Next => NT Apm/Legacy Support & Next => Next

(again) a few times. Now the driver is installed and Windows 2000 now

@subsubsection Share a directory between Unix and Windows

QEMU emulates the following PowerMac peripherals:

@itemize @minus

@item

PCI VGA compatible card with VESA Bochs Extensions

2 PMAC IDE interfaces with hard disk and CD-ROM support

NE2000 PCI adapters

@item

Non Volatile RAM

QEMU emulates the following PREP peripherals:

@itemize @minus

PCI Bridge

@item

PCI VGA compatible card with VESA Bochs Extensions

2 IDE interfaces with hard disk and CD-ROM support

@item

Floppy disk

NE2000 network adapters

@item

Serial port

@table @option

Set the initial VGA graphic mode. The default is 800x600x15.

@end table

More information is available at

IOMMU

@item

TCX Frame buffer

Lance (Am7990) Ethernet

@item

Non Volatile RAM M48T08

@end table

@node Sparc64 System emulator

@section Sparc64 System emulator

@itemize @minus

@item

@item

PCI VGA compatible card with VESA Bochs Extensions

@item

emulated:

@itemize @minus

MIPS 24Kf CPU

@item

PC style serial port

ARM926E, ARM1026E or ARM946E CPU

@item

Two PL011 UARTs

SMC 91c111 Ethernet adapter

@item

PL110 LCD controller

PL190 Vectored Interrupt Controller

@item

Four PL011 UARTs

SMC 91c111 Ethernet adapter

@item

PL110 LCD controller

ARM AMBA Generic/Distributed Interrupt Controller

@item

Four PL011 UARTs

SMC 91c111 Ethernet adapter

@item

PL110 LCD controller

The M5208EVB emulation includes the following devices:

@itemize @minus

MCF5208 ColdFire V2 Microprocessor (ISA A+ with EMAC).

@item

Three Two on-chip UARTs.

The AN5206 emulation includes the following devices:

@itemize @minus

MCF5206 ColdFire V2 Microprocessor.

@item

Two on-chip UARTs.

@end itemize

@menu

* Supported Operating Systems ::

@subsection Quick Start

In order to launch a Linux process, QEMU needs the process executable

@itemize

@item On x86, you can just try to launch any process by using the native

libraries:

qemu-i386 -L / /bin/ls

@end example

@item Since QEMU is also a linux process, you can launch qemu with

qemu (NOTE: you can only do that if you compiled QEMU from the sources):

qemu-i386 -L / qemu-i386 -L / /bin/ls

@end example

@code{LD_LIBRARY_PATH} is not set:

@example

@end example

Then you can launch the precompiled @file{ls} x86 executable:

@end example

@item Download the binary x86 Wine install

@item Configure Wine on your account. Look at the provided script

@file{/usr/local/qemu-i386/@/bin/wine-conf.sh}. Your previous

@table @option

@item -h

Print the help

Set the x86 elf interpreter prefix (default=/usr/local/qemu-i386)

@item -s size

Set the x86 stack size in bytes (default=524288)

@item On x86, you can just try to launch any process by using the native

libraries:

qemu-i386 /bin/ls

@end example

or to run the ppc version of the executable:

qemu-ppc /bin/ls

@end example

@item On ppc, you'll have to tell qemu where your x86 libraries (and dynamic linker)

are installed:

qemu-i386 -L /opt/x86_root/ /bin/ls

@end example

@table @option

@item -h

Print the help

Set the library root path (default=/)

@item -s size

Set the stack size in bytes (default=524288)

@url{http://www.mingw.org/}. You can find detailed installation

instructions in the download section and the FAQ.

the MinGW development library of SDL 1.2.x

(@file{SDL-devel-1.2.x-@/mingw32.tar.gz}) from

@url{http://www.libsdl.org}. Unpack it in a temporary place, and

correct SDL directory when invoked.

@item Extract the current version of QEMU.

@item Start the MSYS shell (file @file{msys.bat}).

@file{make}.  If you have problems using SDL, verify that

@file{sdl-config} can be launched from the MSYS command line.

@file{make install}. Don't forget to copy @file{SDL.dll} in

@file{Program Files/Qemu}.

Install the MinGW cross compilation tools available at

@url{http://www.mingw.org/}.

Install the Win32 version of SDL (@url{http://www.libsdl.org}) by

unpacking @file{i386-mingw32msvc.tar.gz}. Set up the PATH environment

variable so that @file{i386-mingw32msvc-sdl-config} can be launched by

the QEMU configuration script.

Configure QEMU for Windows cross compilation:

@example

./configure --enable-mingw32

chosen for the MinGW tools with --cross-prefix. You can also use

--prefix to set the Win32 install path.

@file{make install}. Don't forget to copy @file{SDL.dll} in the

@end itemize