<HTML>
<HEAD>
-<!-- Created by texi2html 1.56k from qemu-doc.texi on 26 April 2005 -->
+<!-- Created by texi2html 1.56k from qemu-doc.texi on 24 July 2005 -->
<TITLE>QEMU CPU Emulator User Documentation</TITLE>
</HEAD>
<UL>
<LI><A NAME="TOC27" HREF="qemu-doc.html#SEC27">3.10.2.1 SVGA graphic modes support</A>
<LI><A NAME="TOC28" HREF="qemu-doc.html#SEC28">3.10.2.2 CPU usage reduction</A>
-<LI><A NAME="TOC29" HREF="qemu-doc.html#SEC29">3.10.2.3 Windows 2000 disk full problems</A>
+<LI><A NAME="TOC29" HREF="qemu-doc.html#SEC29">3.10.2.3 Windows 2000 disk full problem</A>
<LI><A NAME="TOC30" HREF="qemu-doc.html#SEC30">3.10.2.4 Windows XP security problems</A>
</UL>
<LI><A NAME="TOC31" HREF="qemu-doc.html#SEC31">3.10.3 MS-DOS and FreeDOS</A>
</UL>
</UL>
<LI><A NAME="TOC33" HREF="qemu-doc.html#SEC33">4. QEMU PowerPC System emulator invocation</A>
-<LI><A NAME="TOC34" HREF="qemu-doc.html#SEC34">5. Sparc System emulator invocation</A>
-<LI><A NAME="TOC35" HREF="qemu-doc.html#SEC35">6. QEMU User space emulator invocation</A>
+<LI><A NAME="TOC34" HREF="qemu-doc.html#SEC34">5. Sparc32 System emulator invocation</A>
+<LI><A NAME="TOC35" HREF="qemu-doc.html#SEC35">6. Sparc64 System emulator invocation</A>
+<LI><A NAME="TOC36" HREF="qemu-doc.html#SEC36">7. MIPS System emulator invocation</A>
+<LI><A NAME="TOC37" HREF="qemu-doc.html#SEC37">8. QEMU User space emulator invocation</A>
<UL>
-<LI><A NAME="TOC36" HREF="qemu-doc.html#SEC36">6.1 Quick Start</A>
-<LI><A NAME="TOC37" HREF="qemu-doc.html#SEC37">6.2 Wine launch</A>
-<LI><A NAME="TOC38" HREF="qemu-doc.html#SEC38">6.3 Command line options</A>
+<LI><A NAME="TOC38" HREF="qemu-doc.html#SEC38">8.1 Quick Start</A>
+<LI><A NAME="TOC39" HREF="qemu-doc.html#SEC39">8.2 Wine launch</A>
+<LI><A NAME="TOC40" HREF="qemu-doc.html#SEC40">8.3 Command line options</A>
</UL>
-<LI><A NAME="TOC39" HREF="qemu-doc.html#SEC39">7. Compilation from the sources</A>
+<LI><A NAME="TOC41" HREF="qemu-doc.html#SEC41">9. Compilation from the sources</A>
<UL>
-<LI><A NAME="TOC40" HREF="qemu-doc.html#SEC40">7.1 Linux/Unix</A>
+<LI><A NAME="TOC42" HREF="qemu-doc.html#SEC42">9.1 Linux/Unix</A>
<UL>
-<LI><A NAME="TOC41" HREF="qemu-doc.html#SEC41">7.1.1 Compilation</A>
-<LI><A NAME="TOC42" HREF="qemu-doc.html#SEC42">7.1.2 Tested tool versions</A>
+<LI><A NAME="TOC43" HREF="qemu-doc.html#SEC43">9.1.1 Compilation</A>
+<LI><A NAME="TOC44" HREF="qemu-doc.html#SEC44">9.1.2 Tested tool versions</A>
</UL>
-<LI><A NAME="TOC43" HREF="qemu-doc.html#SEC43">7.2 Windows</A>
-<LI><A NAME="TOC44" HREF="qemu-doc.html#SEC44">7.3 Cross compilation for Windows with Linux</A>
-<LI><A NAME="TOC45" HREF="qemu-doc.html#SEC45">7.4 Mac OS X</A>
+<LI><A NAME="TOC45" HREF="qemu-doc.html#SEC45">9.2 Windows</A>
+<LI><A NAME="TOC46" HREF="qemu-doc.html#SEC46">9.3 Cross compilation for Windows with Linux</A>
+<LI><A NAME="TOC47" HREF="qemu-doc.html#SEC47">9.4 Mac OS X</A>
</UL>
</UL>
<P><HR><P>
<LI>
Full system emulation. In this mode, QEMU emulates a full system (for
-example a PC), including a processor and various peripherials. It can
+example a PC), including a processor and various peripherals. It can
be used to launch different Operating Systems without rebooting the
PC or to debug system code.
For system emulation, the following hardware targets are supported:
<UL>
-<LI>PC (x86 processor)
+<LI>PC (x86 or x86_64 processor)
<LI>PREP (PowerPC processor)
-<LI>PowerMac (PowerPC processor, in progress)
+<LI>G3 BW PowerMac (PowerPC processor)
-<LI>Sun4m (Sparc processor, in progress)
+<LI>Mac99 PowerMac (PowerPC processor, in progress)
+
+<LI>Sun4m (32-bit Sparc processor)
+
+<LI>Sun4u (64-bit Sparc processor, in progress)
+
+<LI>Malta board (32-bit MIPS processor, in progress)
</UL>
<P>
-For user emulation, x86, PowerPC, ARM, and SPARC CPUs are supported.
+For user emulation, x86, PowerPC, ARM, and Sparc32/64 CPUs are supported.
<H1><A NAME="SEC3" HREF="qemu-doc.html#TOC3">2. Installation</A></H1>
<P>
-If you want to compile QEMU yourself, see section <A HREF="qemu-doc.html#SEC39">7. Compilation from the sources</A>.
+If you want to compile QEMU yourself, see section <A HREF="qemu-doc.html#SEC41">9. Compilation from the sources</A>.
<P>
If a precompiled package is available for your distribution - you just
-have to install it. Otherwise, see section <A HREF="qemu-doc.html#SEC39">7. Compilation from the sources</A>.
+have to install it. Otherwise, see section <A HREF="qemu-doc.html#SEC41">9. Compilation from the sources</A>.
<P>
The QEMU System emulator simulates the
-following PC peripherials:
+following PC peripherals:
Store the QEMU process PID in <VAR>file</VAR>. It is useful if you launch QEMU
from a script.
+<DT><SAMP>`-win2k-hack'</SAMP>
+<DD>
+Use it when installing Windows 2000 to avoid a disk full bug. After
+Windows 2000 is installed, you no longer need this option (this option
+slows down the IDE transfers).
+
</DL>
<P>
is launched to configure the host network interface (usually tun0)
corresponding to the virtual NE2000 card.
+<DT><SAMP>`-nics n'</SAMP>
+<DD>
+Simulate <VAR>n</VAR> network cards (the default is 1).
+
<DT><SAMP>`-macaddr addr'</SAMP>
<DD>
Set the mac address of the first interface (the format is
previous versions. It does not work on win32.
<DT><CODE>vmdk</CODE>
<DD>
-VMware 3 and 4 compatible image format. Currently only supported as
-read-only.
+VMware 3 and 4 compatible image format.
<DT><CODE>cloop</CODE>
<DD>
Linux Compressed Loop image, useful only to reuse directly compressed
-<H4><A NAME="SEC29" HREF="qemu-doc.html#TOC29">3.10.2.3 Windows 2000 disk full problems</A></H4>
+<H4><A NAME="SEC29" HREF="qemu-doc.html#TOC29">3.10.2.3 Windows 2000 disk full problem</A></H4>
<P>
-Currently (release 0.6.0) QEMU has a bug which gives a <CODE>disk
-full</CODE> error during installation of some releases of Windows 2000. The
-workaround is to stop QEMU as soon as you notice that your disk image
-size is growing too fast (monitor it with <CODE>ls -ls</CODE>). Then
-relaunch QEMU to continue the installation. If you still experience
-the problem, relaunch QEMU again.
-
-
-<P>
-Future QEMU releases are likely to correct this bug.
+Windows 2000 has a bug which gives a disk full problem during its
+installation. When installing it, use the <SAMP>`-win2k-hack'</SAMP> QEMU
+option to enable a specific workaround. After Windows 2000 is
+installed, you no longer need this option (this option slows down the
+IDE transfers).
<P>
-QEMU emulates the following PowerMac peripherials:
+QEMU emulates the following PowerMac peripherals:
</UL>
<P>
-QEMU emulates the following PREP peripherials:
+QEMU emulates the following PREP peripherals:
-<H1><A NAME="SEC34" HREF="qemu-doc.html#TOC34">5. Sparc System emulator invocation</A></H1>
+<H1><A NAME="SEC34" HREF="qemu-doc.html#TOC34">5. Sparc32 System emulator invocation</A></H1>
<P>
Use the executable <TT>`qemu-system-sparc'</TT> to simulate a JavaStation
-(sun4m architecture). The emulation is far from complete.
+(sun4m architecture). The emulation is somewhat complete.
<P>
-QEMU emulates the following sun4m peripherials:
+QEMU emulates the following sun4m peripherals:
Non Volatile RAM M48T08
<LI>
-Slave I/O: timers, interrupt controllers, Zilog serial ports
+Slave I/O: timers, interrupt controllers, Zilog serial ports, keyboard
+and power/reset logic
+<LI>
+
+ESP SCSI controller with hard disk and CD-ROM support
+<LI>
+
+Floppy drive
</UL>
<P>
+The number of peripherals is fixed in the architecture.
+
+
+<P>
QEMU uses the Proll, a PROM replacement available at
-<A HREF="http://people.redhat.com/zaitcev/linux/">http://people.redhat.com/zaitcev/linux/</A>.
+<A HREF="http://people.redhat.com/zaitcev/linux/">http://people.redhat.com/zaitcev/linux/</A>. The required
+QEMU-specific patches are included with the sources.
+
+
+<P>
+A sample Linux 2.6 series kernel and ram disk image are available on
+the QEMU web site. Please note that currently neither Linux 2.4
+series, NetBSD, nor OpenBSD kernels work.
+
+
+<P>
+The following options are specific to the Sparc emulation:
+
+
+<DL COMPACT>
+
+<DT><SAMP>`-g WxH'</SAMP>
+<DD>
+Set the initial TCX graphic mode. The default is 1024x768.
+
+</DL>
+
+
+
+<H1><A NAME="SEC35" HREF="qemu-doc.html#TOC35">6. Sparc64 System emulator invocation</A></H1>
+
+<P>
+Use the executable <TT>`qemu-system-sparc64'</TT> to simulate a Sun4u machine.
+The emulator is not usable for anything yet.
+
+
+<P>
+QEMU emulates the following sun4u peripherals:
+
+
+
+<UL>
+<LI>
+
+UltraSparc IIi APB PCI Bridge
+<LI>
+
+PCI VGA compatible card with VESA Bochs Extensions
+<LI>
+
+Non Volatile RAM M48T59
+<LI>
+
+PC-compatible serial ports
+</UL>
+
+
+<H1><A NAME="SEC36" HREF="qemu-doc.html#TOC36">7. MIPS System emulator invocation</A></H1>
<P>
-A sample Linux kernel and ram disk image are available on the QEMU web
-site.
+Use the executable <TT>`qemu-system-mips'</TT> to simulate a MIPS machine.
+The emulator begins to launch a Linux kernel.
-<H1><A NAME="SEC35" HREF="qemu-doc.html#TOC35">6. QEMU User space emulator invocation</A></H1>
+<H1><A NAME="SEC37" HREF="qemu-doc.html#TOC37">8. QEMU User space emulator invocation</A></H1>
-<H2><A NAME="SEC36" HREF="qemu-doc.html#TOC36">6.1 Quick Start</A></H2>
+<H2><A NAME="SEC38" HREF="qemu-doc.html#TOC38">8.1 Quick Start</A></H2>
<P>
In order to launch a Linux process, QEMU needs the process executable
-<H2><A NAME="SEC37" HREF="qemu-doc.html#TOC37">6.2 Wine launch</A></H2>
+<H2><A NAME="SEC39" HREF="qemu-doc.html#TOC39">8.2 Wine launch</A></H2>
<UL>
-<H2><A NAME="SEC38" HREF="qemu-doc.html#TOC38">6.3 Command line options</A></H2>
+<H2><A NAME="SEC40" HREF="qemu-doc.html#TOC40">8.3 Command line options</A></H2>
<PRE>
-<H1><A NAME="SEC39" HREF="qemu-doc.html#TOC39">7. Compilation from the sources</A></H1>
+<H1><A NAME="SEC41" HREF="qemu-doc.html#TOC41">9. Compilation from the sources</A></H1>
-<H2><A NAME="SEC40" HREF="qemu-doc.html#TOC40">7.1 Linux/Unix</A></H2>
+<H2><A NAME="SEC42" HREF="qemu-doc.html#TOC42">9.1 Linux/Unix</A></H2>
-<H3><A NAME="SEC41" HREF="qemu-doc.html#TOC41">7.1.1 Compilation</A></H3>
+<H3><A NAME="SEC43" HREF="qemu-doc.html#TOC43">9.1.1 Compilation</A></H3>
<P>
First you must decompress the sources:
-<H3><A NAME="SEC42" HREF="qemu-doc.html#TOC42">7.1.2 Tested tool versions</A></H3>
+<H3><A NAME="SEC44" HREF="qemu-doc.html#TOC44">9.1.2 Tested tool versions</A></H3>
<P>
In order to compile QEMU succesfully, it is very important that you
-<H2><A NAME="SEC43" HREF="qemu-doc.html#TOC43">7.2 Windows</A></H2>
+<H2><A NAME="SEC45" HREF="qemu-doc.html#TOC45">9.2 Windows</A></H2>
<UL>
-<H2><A NAME="SEC44" HREF="qemu-doc.html#TOC44">7.3 Cross compilation for Windows with Linux</A></H2>
+<H2><A NAME="SEC46" HREF="qemu-doc.html#TOC46">9.3 Cross compilation for Windows with Linux</A></H2>
<UL>
-<H2><A NAME="SEC45" HREF="qemu-doc.html#TOC45">7.4 Mac OS X</A></H2>
+<H2><A NAME="SEC47" HREF="qemu-doc.html#TOC47">9.4 Mac OS X</A></H2>
<P>
The Mac OS X patches are not fully merged in QEMU, so you should look
<P><HR><P>
-This document was generated on 26 April 2005 using
+This document was generated on 24 July 2005 using
<A HREF="http://wwwinfo.cern.ch/dis/texi2html/">texi2html</A> 1.56k.
</BODY>
</HTML>
projects / qemu / blobdiff