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
|
||||
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:
|
||||
|
||||
http://qemu-project.org/Hosts/Linux
|
||||
|
||||
249
qemu-doc.texi
249
qemu-doc.texi
@ -32,11 +32,9 @@
|
||||
|
||||
@menu
|
||||
* Introduction::
|
||||
* Installation::
|
||||
* QEMU PC System emulator::
|
||||
* QEMU System emulator for non PC targets::
|
||||
* QEMU User space emulator::
|
||||
* compilation:: Compilation from the sources
|
||||
* License::
|
||||
* Index::
|
||||
@end menu
|
||||
@ -121,39 +119,6 @@ accelerator is required to use more than one host CPU for emulation.
|
||||
@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
|
||||
@chapter QEMU PC System emulator
|
||||
@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.
|
||||
@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
|
||||
@appendix License
|
||||
|
||||
Loading…
Reference in New Issue
Block a user