UniNorth PCI bridge support
[qemu] / qemu-doc.texi
index 51f4d7c..5c44879 100644 (file)
@@ -61,7 +61,7 @@ tar zxvf /tmp/qemu-XXX-i386.tar.gz
 @end example
 
 @section Windows
-w
+
 @itemize
 @item Install the current versions of MSYS and MinGW from
 @url{http://www.mingw.org/}. You can find detailed installation
@@ -196,7 +196,8 @@ General options:
 @table @option
 @item -fda file
 @item -fdb file
-Use @var{file} as floppy disk 0/1 image (@xref{disk_images}).
+Use @var{file} as floppy disk 0/1 image (@xref{disk_images}). You can
+use the host floppy by using @file{/dev/fd0} as filename.
 
 @item -hda file
 @item -hdb file
@@ -206,7 +207,8 @@ Use @var{file} as hard disk 0, 1, 2 or 3 image (@xref{disk_images}).
 
 @item -cdrom file
 Use @var{file} as CD-ROM image (you cannot use @option{-hdc} and and
-@option{-cdrom} at the same time).
+@option{-cdrom} at the same time). You can use the host CD-ROM by
+using @file{/dev/cdrom} as filename.
 
 @item -boot [a|c|d]
 Boot on floppy (a), hard disk (c) or CD-ROM (d). Hard disk boot is
@@ -231,6 +233,11 @@ command line application. The emulated serial port is redirected on
 the console. Therefore, you can still use QEMU to debug a Linux kernel
 with a serial console.
 
+@item -enable-audio
+
+The SB16 emulation is disabled by default as it may give problems with
+Windows. You can enable it manually with this option.
+
 @end table
 
 Network options:
@@ -292,22 +299,30 @@ Do not start CPU at startup (you must type 'c' in the monitor).
 Output log in /tmp/qemu.log
 @end table
 
+During the graphical emulation, you can use the following keys:
+@table @key
+@item Ctrl-Shift
+Toggle mouse and keyboard grab.
+@item Ctrl-Shift-f
+Toggle full screen
+@end table
+
 During emulation, if you are using the serial console, use @key{C-a h}
 to get terminal commands:
 
 @table @key
-@item C-a h
+@item Ctrl-a h
 Print this help
-@item C-a x    
+@item Ctrl-a x    
 Exit emulatior
-@item C-a s    
+@item Ctrl-a s    
 Save disk data back to file (if -snapshot)
-@item C-a b
+@item Ctrl-a b
 Send break (magic sysrq in Linux)
-@item C-a c
+@item Ctrl-a c
 Switch between console and monitor
-@item C-a C-a
-Send C-a
+@item Ctrl-a Ctrl-a
+Send Ctrl-a
 @end table
 @c man end
 
@@ -469,6 +484,17 @@ Dump 80 16 bit values at the start of the video memory.
 Print expression value. Only the @var{format} part of @var{fmt} is
 used.
 
+@item sendkey keys
+
+Send @var{keys} to the emulator. Use @code{-} to press several keys
+simultaneously. Example:
+@example
+sendkey ctrl-alt-f1
+@end example
+
+This command is useful to send keys that your graphical user interface
+intercepts at low level, such as @code{ctrl-alt-f1} in X Window.
+
 @end table
 
 @subsection Integer expressions
@@ -485,7 +511,7 @@ CPU registers by prefixing them with @emph{$}.
 The disk images can simply be raw images of the hard disk. You can
 create them with the command:
 @example
-dd if=/dev/zero of=myimage bs=1024 count=mysize
+dd of=myimage bs=1024 seek=mysize count=0
 @end example
 where @var{myimage} is the image filename and @var{mysize} is its size
 in kilobytes.
@@ -548,6 +574,14 @@ Since holes are used, the displayed size of the COW disk image is not
 the real one. To know it, use the @code{ls -ls} command.
 @end enumerate
 
+@subsection Convert VMware disk images to raw disk images
+
+You can use the tool @file{vmdk2raw} to convert VMware disk images to
+raw disk images directly usable by QEMU. The syntax is:
+@example
+vmdk2raw vmware_image output_image
+@end example
+
 @section Network emulation
 
 QEMU simulates up to 6 networks cards (NE2000 boards). Each card can
@@ -571,12 +605,10 @@ Linux distribution.
 
 @subsection Using the user mode network stack
 
-This is @emph{experimental} (version 0.5.4). You must configure qemu
-with @code{--enable-slirp}. Then by using the option
-@option{-user-net} or if you have no tun/tap init script, QEMU uses a
-completely user mode network stack (you don't need root priviledge to
-use the virtual network). The virtual network configuration is the
-following:
+By using the option @option{-user-net} or if you have no tun/tap init
+script, QEMU uses a completely user mode network stack (you don't need
+root priviledge to use the virtual network). The virtual network
+configuration is the following:
 
 @example
 
@@ -595,6 +627,12 @@ In order to check that the user mode network is working, you can ping
 the address 10.0.2.2 and verify that you got an address in the range
 10.0.2.x from the QEMU virtual DHCP server.
 
+Note that @code{ping} is not supported reliably to the internet as it
+would require root priviledges. It means you can only ping the local
+router (10.0.2.2).
+
+The user mode network is currently only supported on a Unix host.
+
 @node direct_linux_boot
 @section Direct Linux Boot
 
@@ -862,6 +900,44 @@ Use @code{set architecture i8086} to dump 16 bit code. Then use
 @code{x/10i $cs*16+*eip} to dump the code at the PC position.
 @end enumerate
 
+@section Target OS specific information
+
+@subsection Linux
+
+To have access to SVGA graphic modes under X11, use the @code{vesa}
+X11 driver. For optimal performances, use the same depth as your
+native display.
+
+@subsection Windows
+
+If you have a slow host, using Windows 95 is better as it gives the
+best speed. Windows 2000 is also a good choice.
+
+SVGA graphic modes support: QEMU currently supports the Bochs VESA VBE
+extensions. It supports color depths of 8, 15, 16 and 32 bits per
+pixel in 640x480, 800x600 and 1024x768. For optimal performances, use
+the same depth as your native display.
+
+@itemize
+
+@item Windows XP: it should be automatically detected.
+
+@item Windows NT4 or 2000: use the driver
+@url{http://www.volny.cz/xnavara/qemuvid_bin.zip} by Filip Navara.
+
+@item Windows 95/98/Me: no clean solution yet (but it will change
+soon). You can however use the shareware driver from SciTech. Here are
+the steps recommended by Christophe Bothamy on the Bochs mailing list:
+
+@itemize
+@item install win95 with the VGA driver.
+@item download sdd 7 beta from @url{http://www.majorgeeks.com/download382.html}
+@item download pmhelp.vxd from @url{http://unununium.org/viewcvs/snap/redist/release/pmhelp.vxd}
+@item copy pmhelp.vxd to the win95 system directory
+@item install sdd7
+@end itemize
+@end itemize
+
 @chapter QEMU PREP PowerPC System emulator invocation
 
 Use the executable @file{qemu-system-ppc} to simulate a complete PREP