blob: a70af3cfb66302379bd3bc1cb2ffe2ef7cf58997 [file] [log] [blame]
The QEMU x86 emulator
---------------------
INSTALLATION
------------
Type
./configure --interp-prefix=/usr/local/qemu-i386
make
to build qemu and libqemu.a.
Type
make install
to install QEMU in /usr/local/bin
* On x86 you should be able to launch any program by using the
libraries installed on your PC. For example:
./qemu -L / /bin/ls
* On non x86 CPUs, you need first to download at least an x86 glibc
(qemu-XXX-i386-glibc21.tar.gz on the qemu web page). Ensure that
LD_LIBRARY_PATH is not set:
unset LD_LIBRARY_PATH
Then you can launch the precompiled 'ls' x86 executable:
./qemu /usr/local/qemu-i386/bin/ls-i386
You can look at /usr/local/qemu-i386/bin/qemu-conf.sh so that QEMU is
automatically launched by the Linux kernel when you try to launch x86
executables.
Tested tool versions
--------------------
In order to compile QEMU succesfully, it is very important that you
have the right tools. The most important one is gcc. I cannot guaranty
that QEMU works if you do not use a tested gcc version. Look at
'configure' and 'Makefile' if you want to make a different gcc
version.
host gcc binutils glibc linux
-------------------------------------------------------
x86 2.95.2 2.13.2 2.1.3 2.4.18
PowerPC 2.95.4 2.12.90.0.1 2.2.5 2.4.20-pre2
Alpha 3.3 [1] 2.14.90.0.4 2.2.5 xxx
[1] QEMU cannot work for gcc version < 3.3 on Alpha.
Documentation
-------------
Read the documentation in qemu-doc.html.
Fabrice Bellard.