mirror of https://github.com/xqemu/xqemu.git
qemu-doc: drop installation and compilation notes
These are in README or obsolete, and the detailed version can be on a website instead. Reviewed-by: Emilio G. Cota <cota@braap.org> Signed-off-by: Paolo Bonzini <pbonzini@redhat.com>
This commit is contained in:
Paolo Bonzini
parent
1f3e7e41bb
commit
81f265a8a4
2
README
2
README
|
|
@ -42,8 +42,6 @@ of other UNIX targets. The simple steps to build QEMU are:
|
||||||
../configure
|
../configure
|
||||||
make
|
make
|
||||||
|
|
||||||
Complete details of the process for building and configuring QEMU for
|
|
||||||
all supported host platforms can be found in the qemu-tech.html file.
|
|
||||||
Additional information can also be found online via the QEMU website:
|
Additional information can also be found online via the QEMU website:
|
||||||
|
|
||||||
http://qemu-project.org/Hosts/Linux
|
http://qemu-project.org/Hosts/Linux
|
||||||
|
|
|
||||||
249
qemu-doc.texi
249
qemu-doc.texi
|
|
@ -32,11 +32,9 @@
|
||||||
|
|
||||||
@menu
|
@menu
|
||||||
* Introduction::
|
* Introduction::
|
||||||
* Installation::
|
|
||||||
* QEMU PC System emulator::
|
* QEMU PC System emulator::
|
||||||
* QEMU System emulator for non PC targets::
|
* QEMU System emulator for non PC targets::
|
||||||
* QEMU User space emulator::
|
* QEMU User space emulator::
|
||||||
* compilation:: Compilation from the sources
|
|
||||||
* License::
|
* License::
|
||||||
* Index::
|
* Index::
|
||||||
@end menu
|
@end menu
|
||||||
|
|
@ -121,39 +119,6 @@ accelerator is required to use more than one host CPU for emulation.
|
||||||
@end itemize
|
@end itemize
|
||||||
|
|
||||||
|
|
||||||
@node Installation
|
|
||||||
@chapter Installation
|
|
||||||
|
|
||||||
If you want to compile QEMU yourself, see @ref{compilation}.
|
|
||||||
|
|
||||||
@menu
|
|
||||||
* install_linux:: Linux
|
|
||||||
* install_windows:: Windows
|
|
||||||
* install_mac:: Macintosh
|
|
||||||
@end menu
|
|
||||||
|
|
||||||
@node install_linux
|
|
||||||
@section Linux
|
|
||||||
@cindex installation (Linux)
|
|
||||||
|
|
||||||
If a precompiled package is available for your distribution - you just
|
|
||||||
have to install it. Otherwise, see @ref{compilation}.
|
|
||||||
|
|
||||||
@node install_windows
|
|
||||||
@section Windows
|
|
||||||
@cindex installation (Windows)
|
|
||||||
|
|
||||||
Download the experimental binary installer at
|
|
||||||
@url{http://www.free.oszoo.org/@/download.html}.
|
|
||||||
TODO (no longer available)
|
|
||||||
|
|
||||||
@node install_mac
|
|
||||||
@section Mac OS X
|
|
||||||
|
|
||||||
Download the experimental binary installer at
|
|
||||||
@url{http://www.free.oszoo.org/@/download.html}.
|
|
||||||
TODO (no longer available)
|
|
||||||
|
|
||||||
@node QEMU PC System emulator
|
@node QEMU PC System emulator
|
||||||
@chapter QEMU PC System emulator
|
@chapter QEMU PC System emulator
|
||||||
@cindex system emulation (PC)
|
@cindex system emulation (PC)
|
||||||
|
|
@ -2949,220 +2914,6 @@ Act as if the host page size was 'pagesize' bytes
|
||||||
Run the emulation in single step mode.
|
Run the emulation in single step mode.
|
||||||
@end table
|
@end table
|
||||||
|
|
||||||
@node compilation
|
|
||||||
@chapter Compilation from the sources
|
|
||||||
|
|
||||||
@menu
|
|
||||||
* Linux/Unix::
|
|
||||||
* Windows::
|
|
||||||
* Cross compilation for Windows with Linux::
|
|
||||||
* Mac OS X::
|
|
||||||
* Make targets::
|
|
||||||
@end menu
|
|
||||||
|
|
||||||
@node Linux/Unix
|
|
||||||
@section Linux/Unix
|
|
||||||
|
|
||||||
@subsection Compilation
|
|
||||||
|
|
||||||
First you must decompress the sources:
|
|
||||||
@example
|
|
||||||
cd /tmp
|
|
||||||
tar zxvf qemu-x.y.z.tar.gz
|
|
||||||
cd qemu-x.y.z
|
|
||||||
@end example
|
|
||||||
|
|
||||||
Then you configure QEMU and build it (usually no options are needed):
|
|
||||||
@example
|
|
||||||
./configure
|
|
||||||
make
|
|
||||||
@end example
|
|
||||||
|
|
||||||
Then type as root user:
|
|
||||||
@example
|
|
||||||
make install
|
|
||||||
@end example
|
|
||||||
to install QEMU in @file{/usr/local}.
|
|
||||||
|
|
||||||
@node Windows
|
|
||||||
@section Windows
|
|
||||||
|
|
||||||
@itemize
|
|
||||||
@item Install the current versions of MSYS and MinGW from
|
|
||||||
@url{http://www.mingw.org/}. You can find detailed installation
|
|
||||||
instructions in the download section and the FAQ.
|
|
||||||
|
|
||||||
@item Download
|
|
||||||
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
|
|
||||||
edit the @file{sdl-config} script so that it gives the
|
|
||||||
correct SDL directory when invoked.
|
|
||||||
|
|
||||||
@item Install the MinGW version of zlib and make sure
|
|
||||||
@file{zlib.h} and @file{libz.dll.a} are in
|
|
||||||
MinGW's default header and linker search paths.
|
|
||||||
|
|
||||||
@item Extract the current version of QEMU.
|
|
||||||
|
|
||||||
@item Start the MSYS shell (file @file{msys.bat}).
|
|
||||||
|
|
||||||
@item Change to the QEMU directory. Launch @file{./configure} and
|
|
||||||
@file{make}. If you have problems using SDL, verify that
|
|
||||||
@file{sdl-config} can be launched from the MSYS command line.
|
|
||||||
|
|
||||||
@item You can install QEMU in @file{Program Files/QEMU} by typing
|
|
||||||
@file{make install}. Don't forget to copy @file{SDL.dll} in
|
|
||||||
@file{Program Files/QEMU}.
|
|
||||||
|
|
||||||
@end itemize
|
|
||||||
|
|
||||||
@node Cross compilation for Windows with Linux
|
|
||||||
@section Cross compilation for Windows with Linux
|
|
||||||
|
|
||||||
@itemize
|
|
||||||
@item
|
|
||||||
Install the MinGW cross compilation tools available at
|
|
||||||
@url{http://www.mingw.org/}.
|
|
||||||
|
|
||||||
@item Download
|
|
||||||
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
|
|
||||||
edit the @file{sdl-config} script so that it gives the
|
|
||||||
correct SDL directory when invoked. Set up the @code{PATH} environment
|
|
||||||
variable so that @file{sdl-config} can be launched by
|
|
||||||
the QEMU configuration script.
|
|
||||||
|
|
||||||
@item Install the MinGW version of zlib and make sure
|
|
||||||
@file{zlib.h} and @file{libz.dll.a} are in
|
|
||||||
MinGW's default header and linker search paths.
|
|
||||||
|
|
||||||
@item
|
|
||||||
Configure QEMU for Windows cross compilation:
|
|
||||||
@example
|
|
||||||
PATH=/usr/i686-pc-mingw32/sys-root/mingw/bin:$PATH ./configure --cross-prefix='i686-pc-mingw32-'
|
|
||||||
@end example
|
|
||||||
The example assumes @file{sdl-config} is installed under @file{/usr/i686-pc-mingw32/sys-root/mingw/bin} and
|
|
||||||
MinGW cross compilation tools have names like @file{i686-pc-mingw32-gcc} and @file{i686-pc-mingw32-strip}.
|
|
||||||
We set the @code{PATH} environment variable to ensure the MinGW version of @file{sdl-config} is used and
|
|
||||||
use --cross-prefix to specify the name of the cross compiler.
|
|
||||||
You can also use --prefix to set the Win32 install path which defaults to @file{c:/Program Files/QEMU}.
|
|
||||||
|
|
||||||
Under Fedora Linux, you can run:
|
|
||||||
@example
|
|
||||||
yum -y install mingw32-gcc mingw32-SDL mingw32-zlib
|
|
||||||
@end example
|
|
||||||
to get a suitable cross compilation environment.
|
|
||||||
|
|
||||||
@item You can install QEMU in the installation directory by typing
|
|
||||||
@code{make install}. Don't forget to copy @file{SDL.dll} and @file{zlib1.dll} into the
|
|
||||||
installation directory.
|
|
||||||
|
|
||||||
@end itemize
|
|
||||||
|
|
||||||
Wine can be used to launch the resulting qemu-system-i386.exe
|
|
||||||
and all other qemu-system-@var{target}.exe compiled for Win32.
|
|
||||||
|
|
||||||
@node Mac OS X
|
|
||||||
@section Mac OS X
|
|
||||||
|
|
||||||
System Requirements:
|
|
||||||
@itemize
|
|
||||||
@item Mac OS 10.5 or higher
|
|
||||||
@item The clang compiler shipped with Xcode 4.2 or higher,
|
|
||||||
or GCC 4.3 or higher
|
|
||||||
@end itemize
|
|
||||||
|
|
||||||
Additional Requirements (install in order):
|
|
||||||
@enumerate
|
|
||||||
@item libffi: @uref{https://sourceware.org/libffi/}
|
|
||||||
@item gettext: @uref{http://www.gnu.org/software/gettext/}
|
|
||||||
@item glib: @uref{http://ftp.gnome.org/pub/GNOME/sources/glib/}
|
|
||||||
@item pkg-config: @uref{http://www.freedesktop.org/wiki/Software/pkg-config/}
|
|
||||||
@item autoconf: @uref{http://www.gnu.org/software/autoconf/autoconf.html}
|
|
||||||
@item automake: @uref{http://www.gnu.org/software/automake/}
|
|
||||||
@item pixman: @uref{http://www.pixman.org/}
|
|
||||||
@end enumerate
|
|
||||||
|
|
||||||
* You may find it easiest to get these from a third-party packager
|
|
||||||
such as Homebrew, Macports, or Fink.
|
|
||||||
|
|
||||||
After downloading the QEMU source code, double-click it to expand it.
|
|
||||||
|
|
||||||
Then configure and make QEMU:
|
|
||||||
@example
|
|
||||||
./configure
|
|
||||||
make
|
|
||||||
@end example
|
|
||||||
|
|
||||||
If you have a recent version of Mac OS X (OSX 10.7 or better
|
|
||||||
with Xcode 4.2 or better) we recommend building QEMU with the
|
|
||||||
default compiler provided by Apple, for your version of Mac OS X
|
|
||||||
(which will be 'clang'). The configure script will
|
|
||||||
automatically pick this.
|
|
||||||
|
|
||||||
Note: If after the configure step you see a message like this:
|
|
||||||
@example
|
|
||||||
ERROR: Your compiler does not support the __thread specifier for
|
|
||||||
Thread-Local Storage (TLS). Please upgrade to a version that does.
|
|
||||||
@end example
|
|
||||||
you may have to build your own version of gcc from source. Expect that to take
|
|
||||||
several hours. More information can be found here:
|
|
||||||
@uref{https://gcc.gnu.org/install/} @*
|
|
||||||
|
|
||||||
These are some of the third party binaries of gcc available for download:
|
|
||||||
@itemize
|
|
||||||
@item Homebrew: @uref{http://brew.sh/}
|
|
||||||
@item @uref{https://www.litebeam.net/gcc/gcc_472.pkg}
|
|
||||||
@item @uref{http://www.macports.org/ports.php?by=name&substr=gcc}
|
|
||||||
@end itemize
|
|
||||||
|
|
||||||
You can have several versions of GCC on your system. To specify a certain version,
|
|
||||||
use the --cc and --cxx options.
|
|
||||||
@example
|
|
||||||
./configure --cxx=<path of your c++ compiler> --cc=<path of your c compiler> <other options>
|
|
||||||
@end example
|
|
||||||
|
|
||||||
@node Make targets
|
|
||||||
@section Make targets
|
|
||||||
|
|
||||||
@table @code
|
|
||||||
|
|
||||||
@item make
|
|
||||||
@item make all
|
|
||||||
Make everything which is typically needed.
|
|
||||||
|
|
||||||
@item install
|
|
||||||
TODO
|
|
||||||
|
|
||||||
@item install-doc
|
|
||||||
TODO
|
|
||||||
|
|
||||||
@item make clean
|
|
||||||
Remove most files which were built during make.
|
|
||||||
|
|
||||||
@item make distclean
|
|
||||||
Remove everything which was built during make.
|
|
||||||
|
|
||||||
@item make dvi
|
|
||||||
@item make html
|
|
||||||
@item make info
|
|
||||||
@item make pdf
|
|
||||||
Create documentation in dvi, html, info or pdf format.
|
|
||||||
|
|
||||||
@item make cscope
|
|
||||||
TODO
|
|
||||||
|
|
||||||
@item make defconfig
|
|
||||||
(Re-)create some build configuration files.
|
|
||||||
User made changes will be overwritten.
|
|
||||||
|
|
||||||
@item tar
|
|
||||||
@item tarbin
|
|
||||||
TODO
|
|
||||||
|
|
||||||
@end table
|
|
||||||
|
|
||||||
@node License
|
@node License
|
||||||
@appendix License
|
@appendix License
|
||||||
|
|
|
||||||
Loading…
Reference in New Issue