gwj / at91sam9263 · Commits

Commit 831952376ebb4b18370048172c61159580f4b8dc

Authored by bellard
1 parent 4fe8b87a

Darwin user help (Pierre d'Herbemont) 


git-svn-id: svn://svn.savannah.nongnu.org/qemu/trunk@2386 c046a42c-6fe2-441c-8c8c-71466251a162
Inline Side-by-side
Showing 1 changed file with 115 additions and 9 deletions
qemu-doc.texi
  View file @8319523
@@ -25,7 +25,7 @@ @@ -25,7 +25,7 @@
25 * Installation:: 25 * Installation::
26 * QEMU PC System emulator:: 26 * QEMU PC System emulator::
27 * QEMU System emulator for non PC targets:: 27 * QEMU System emulator for non PC targets::
28 -* QEMU Linux User space emulator:: 28 +* QEMU User space emulator::
29 * compilation:: Compilation from the sources 29 * compilation:: Compilation from the sources
30 * Index:: 30 * Index::
31 @end menu 31 @end menu
@@ -57,8 +57,8 @@ peripherals. It can be used to launch different Operating Systems @@ -57,8 +57,8 @@ peripherals. It can be used to launch different Operating Systems
57 without rebooting the PC or to debug system code. 57 without rebooting the PC or to debug system code.
58 58
59 @item 59 @item
60 -User mode emulation (Linux host only). In this mode, QEMU can launch  
61 -Linux processes compiled for one CPU on another CPU. It can be used to 60 +User mode emulation. In this mode, QEMU can launch
  61 +processes compiled for one CPU on another CPU. It can be used to
62 launch the Wine Windows API emulator (@url{http://www.winehq.org}) or 62 launch the Wine Windows API emulator (@url{http://www.winehq.org}) or
63 to ease cross-compilation and cross-debugging. 63 to ease cross-compilation and cross-debugging.
64 64
@@ -1704,8 +1704,29 @@ LSI53C895A PCI SCSI Host Bus Adapter with hard disk and CD-ROM devices. @@ -1704,8 +1704,29 @@ LSI53C895A PCI SCSI Host Bus Adapter with hard disk and CD-ROM devices.
1704 A Linux 2.6 test image is available on the QEMU web site. More 1704 A Linux 2.6 test image is available on the QEMU web site. More
1705 information is available in the QEMU mailing-list archive. 1705 information is available in the QEMU mailing-list archive.
1706 1706
1707 -@node QEMU Linux User space emulator  
1708 -@chapter QEMU Linux User space emulator 1707 +@node QEMU User space emulator
  1708 +@chapter QEMU User space emulator
  1709 +
  1710 +@menu
  1711 +* Supported Operating Systems ::
  1712 +* Linux User space emulator::
  1713 +* Mac OS X/Darwin User space emulator ::
  1714 +@end menu
  1715 +
  1716 +@node Supported Operating Systems
  1717 +@section Supported Operating Systems
  1718 +
  1719 +The following OS are supported in user space emulation:
  1720 +
  1721 +@itemize @minus
  1722 +@item
  1723 +Linux (refered as qemu-linux-user)
  1724 +@item
  1725 +Mac OS X/Darwin (refered as qemu-darwin-user)
  1726 +@end itemize
  1727 +
  1728 +@node Linux User space emulator
  1729 +@section Linux User space emulator
1709 1730
1710 @menu 1731 @menu
1711 * Quick Start:: 1732 * Quick Start::
@@ -1715,7 +1736,7 @@ information is available in the QEMU mailing-list archive. @@ -1715,7 +1736,7 @@ information is available in the QEMU mailing-list archive.
1715 @end menu 1736 @end menu
1716 1737
1717 @node Quick Start 1738 @node Quick Start
1718 -@section Quick Start 1739 +@subsection Quick Start
1719 1740
1720 In order to launch a Linux process, QEMU needs the process executable 1741 In order to launch a Linux process, QEMU needs the process executable
1721 itself and all the target (x86) dynamic libraries used by it. 1742 itself and all the target (x86) dynamic libraries used by it.
@@ -1765,7 +1786,7 @@ qemu-i386 /usr/local/qemu-i386/bin/qemu-i386 \ @@ -1765,7 +1786,7 @@ qemu-i386 /usr/local/qemu-i386/bin/qemu-i386 \
1765 @end itemize 1786 @end itemize
1766 1787
1767 @node Wine launch 1788 @node Wine launch
1768 -@section Wine launch 1789 +@subsection Wine launch
1769 1790
1770 @itemize 1791 @itemize
1771 1792
@@ -1794,7 +1815,7 @@ qemu-i386 /usr/local/qemu-i386/wine/bin/wine \ @@ -1794,7 +1815,7 @@ qemu-i386 /usr/local/qemu-i386/wine/bin/wine \
1794 @end itemize 1815 @end itemize
1795 1816
1796 @node Command line options 1817 @node Command line options
1797 -@section Command line options 1818 +@subsection Command line options
1798 1819
1799 @example 1820 @example
1800 usage: qemu-i386 [-h] [-d] [-L path] [-s size] program [arguments...] 1821 usage: qemu-i386 [-h] [-d] [-L path] [-s size] program [arguments...]
@@ -1819,7 +1840,7 @@ Act as if the host page size was 'pagesize' bytes @@ -1819,7 +1840,7 @@ Act as if the host page size was 'pagesize' bytes
1819 @end table 1840 @end table
1820 1841
1821 @node Other binaries 1842 @node Other binaries
1822 -@section Other binaries 1843 +@subsection Other binaries
1823 1844
1824 @command{qemu-arm} is also capable of running ARM "Angel" semihosted ELF 1845 @command{qemu-arm} is also capable of running ARM "Angel" semihosted ELF
1825 binaries (as implemented by the arm-elf and arm-eabi Newlib/GDB 1846 binaries (as implemented by the arm-elf and arm-eabi Newlib/GDB
@@ -1831,6 +1852,91 @@ coldfire uClinux bFLT format binaries. @@ -1831,6 +1852,91 @@ coldfire uClinux bFLT format binaries.
1831 1852
1832 The binary format is detected automatically. 1853 The binary format is detected automatically.
1833 1854
  1855 +@node Mac OS X/Darwin User space emulator
  1856 +@section Mac OS X/Darwin User space emulator
  1857 +
  1858 +@menu
  1859 +* Mac OS X/Darwin Status::
  1860 +* Mac OS X/Darwin Quick Start::
  1861 +* Mac OS X/Darwin Command line options::
  1862 +@end menu
  1863 +
  1864 +@node Mac OS X/Darwin Status
  1865 +@subsection Mac OS X/Darwin Status
  1866 +
  1867 +@itemize @minus
  1868 +@item
  1869 +target x86 on x86: Most apps (Cocoa and Carbon too) works. [1]
  1870 +@item
  1871 +target PowerPC on x86: Not working as the ppc commpage can't be mapped (yet!)
  1872 +@item
  1873 +target x86 on x86: Most apps (Cocoa and Carbon too) works. [1]
  1874 +@item
  1875 +target x86 on PowerPC: most utilities work. Cocoa and Carbon apps are not yet supported.
  1876 +@end itemize
  1877 +
  1878 +[1] If you're host commpage can be executed by qemu.
  1879 +
  1880 +@node Mac OS X/Darwin Quick Start
  1881 +@subsection Quick Start
  1882 +
  1883 +In order to launch a Mac OS X/Darwin process, QEMU needs the process executable
  1884 +itself and all the target dynamic libraries used by it. If you don't have the FAT
  1885 +libraries (you're running Mac OS X/ppc) you'll need to obtain it from a Mac OS X
  1886 +CD or compile them by hand.
  1887 +
  1888 +@itemize
  1889 +
  1890 +@item On x86, you can just try to launch any process by using the native
  1891 +libraries:
  1892 +
  1893 +@example
  1894 +qemu-darwin-i386 /bin/ls
  1895 +@end example
  1896 +
  1897 +or to run the ppc version of the executable:
  1898 +
  1899 +@example
  1900 +qemu-darwin-ppc /bin/ls
  1901 +@end example
  1902 +
  1903 +@item On ppc, you'll have to tell qemu where your x86 libraries (and dynamic linker)
  1904 +are installed:
  1905 +
  1906 +@example
  1907 +qemu-darwin-i386 -L /opt/x86_root/ /bin/ls
  1908 +@end example
  1909 +
  1910 +@code{-L /opt/x86_root/} tells that the dynamic linker (dyld) path is in
  1911 +@file{/opt/x86_root/usr/bin/dyld}.
  1912 +
  1913 +@end itemize
  1914 +
  1915 +@node Mac OS X/Darwin Command line options
  1916 +@subsection Command line options
  1917 +
  1918 +@example
  1919 +usage: qemu-darwin-i386 [-h] [-d] [-L path] [-s size] program [arguments...]
  1920 +@end example
  1921 +
  1922 +@table @option
  1923 +@item -h
  1924 +Print the help
  1925 +@item -L path
  1926 +Set the library root path (default=/)
  1927 +@item -s size
  1928 +Set the stack size in bytes (default=524288)
  1929 +@end table
  1930 +
  1931 +Debug options:
  1932 +
  1933 +@table @option
  1934 +@item -d
  1935 +Activate log (logfile=/tmp/qemu.log)
  1936 +@item -p pagesize
  1937 +Act as if the host page size was 'pagesize' bytes
  1938 +@end table
  1939 +
1834 @node compilation 1940 @node compilation
1835 @chapter Compilation from the sources 1941 @chapter Compilation from the sources
1836 1942