Index: qemu-doc.texi =================================================================== RCS file: /sources/qemu/qemu/qemu-doc.texi,v retrieving revision 1.126 diff -u -r1.126 qemu-doc.texi --- qemu-doc.texi 2 Feb 2007 00:37:56 -0000 1.126 +++ qemu-doc.texi 3 Feb 2007 17:11:57 -0000 @@ -25,7 +25,7 @@ * Installation:: * QEMU PC System emulator:: * QEMU System emulator for non PC targets:: -* QEMU Linux User space emulator:: +* QEMU User space emulator:: * compilation:: Compilation from the sources * Index:: @end menu @@ -57,8 +57,8 @@ without rebooting the PC or to debug system code. @item -User mode emulation (Linux host only). In this mode, QEMU can launch -Linux processes compiled for one CPU on another CPU. It can be used to +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 to ease cross-compilation and cross-debugging. @@ -1704,8 +1704,29 @@ A Linux 2.6 test image is available on the QEMU web site. More information is available in the QEMU mailing-list archive. address@hidden QEMU Linux User space emulator address@hidden QEMU Linux User space emulator address@hidden QEMU User space emulator address@hidden QEMU User space emulator + address@hidden +* Supported Operating Systems :: +* Linux User space emulator:: +* Mac OS X/Darwin User space emulator :: address@hidden menu + address@hidden Supported Operating Systems address@hidden Supported Operating Systems + +The following OS are supported in user space emulation: + address@hidden @minus address@hidden +Linux (refered as qemu-linux-user) address@hidden +Mac OS X/Darwin (refered as qemu-darwin-user) address@hidden itemize + address@hidden Linux User space emulator address@hidden Linux User space emulator @menu * Quick Start:: @@ -1715,7 +1736,7 @@ @end menu @node Quick Start address@hidden Quick Start address@hidden Quick Start In order to launch a Linux process, QEMU needs the process executable itself and all the target (x86) dynamic libraries used by it. @@ -1726,7 +1747,7 @@ libraries: @example -qemu-i386 -L / /bin/ls +qemu-linux-i386 -L / /bin/ls @end example @code{-L /} tells that the x86 dynamic linker must be searched with a @@ -1765,7 +1786,7 @@ @end itemize @node Wine launch address@hidden Wine launch address@hidden Wine launch @itemize @@ -1794,7 +1815,7 @@ @end itemize @node Command line options address@hidden Command line options address@hidden Command line options @example usage: qemu-i386 [-h] [-d] [-L path] [-s size] program [arguments...] @@ -1819,7 +1840,7 @@ @end table @node Other binaries address@hidden Other binaries address@hidden 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 @@ -1831,6 +1852,91 @@ The binary format is detected automatically. address@hidden Mac OS X/Darwin User space emulator address@hidden Mac OS X/Darwin User space emulator + address@hidden +* Mac OS X/Darwin Status:: +* Mac OS X/Darwin Quick Start:: +* Mac OS X/Darwin Command line options:: address@hidden menu + address@hidden Mac OS X/Darwin Status address@hidden Mac OS X/Darwin Status + address@hidden @minus address@hidden +target x86 on x86: Most apps (Cocoa and Carbon too) works. [1] address@hidden +target PowerPC on x86: Not working as the ppc commpage can't be mapped (yet!) address@hidden +target x86 on x86: Most apps (Cocoa and Carbon too) works. [1] address@hidden +target x86 on PowerPC: most utilities work. Cocoa and Carbon apps are not yet supported. address@hidden itemize + +[1] If you're host commpage can be executed by qemu. + address@hidden Mac OS X/Darwin Quick Start address@hidden Quick Start + +In order to launch a Mac OS X/Darwin process, QEMU needs the process executable +itself and all the target dynamic libraries used by it. If you don't have the FAT +libraries (you're running Mac OS X/ppc) you'll need to obtain it from a Mac OS X +CD or compile them by hand. + address@hidden + address@hidden On x86, you can just try to launch any process by using the native +libraries: + address@hidden +qemu-darwin-i386 /bin/ls address@hidden example + +or to run the ppc version of the executable: + address@hidden +qemu-darwin-ppc /bin/ls address@hidden example + address@hidden On ppc, you'll have to tell qemu where your x86 libraries (and dynamic linker) +are installed: + address@hidden +qemu-darwin-i386 -L /opt/x86_root/ /bin/ls address@hidden example + address@hidden /opt/x86_root/} tells that the dynamic linker (dyld) path is in address@hidden/opt/x86_root/usr/bin/dyld}. + address@hidden itemize + address@hidden Mac OS X/Darwin Command line options address@hidden Command line options + address@hidden +usage: qemu-darwin-i386 [-h] [-d] [-L path] [-s size] program [arguments...] address@hidden example + address@hidden @option address@hidden -h +Print the help address@hidden -L path +Set the library root path (default=/) address@hidden -s size +Set the stack size in bytes (default=524288) address@hidden table + +Debug options: + address@hidden @option address@hidden -d +Activate log (logfile=/tmp/qemu.log) address@hidden -p pagesize +Act as if the host page size was 'pagesize' bytes address@hidden table + @node compilation @chapter Compilation from the sources