tested tools
[qemu] / README
1 The QEMU x86 emulator
2 ---------------------
3
4 INSTALLATION
5 ------------
6
7 Type 
8
9     ./configure --interp-prefix=/usr/local/qemu-i386
10     make
11
12 to build qemu and libqemu.a.
13
14 Type
15
16     make install
17
18 to install QEMU in /usr/local/bin
19
20 * On x86 you should be able to launch any program by using the
21 libraries installed on your PC. For example:
22
23     ./qemu -L / /bin/ls
24
25 * On non x86 CPUs, you need first to download at least an x86 glibc
26 (qemu-XXX-i386-glibc21.tar.gz on the qemu web page). Ensure that
27 LD_LIBRARY_PATH is not set:
28
29     unset LD_LIBRARY_PATH 
30
31 Then you can launch the precompiled 'ls' x86 executable:
32
33     ./qemu /usr/local/qemu-i386/bin/ls-i386
34
35 You can look at /usr/local/qemu-i386/bin/qemu-conf.sh so that QEMU is
36 automatically launched by the Linux kernel when you try to launch x86
37 executables.
38
39 Tested tool versions
40 --------------------
41
42 In order to compile QEMU succesfully, it is very important that you
43 have the right tools. The most important one is gcc. I cannot guaranty
44 that QEMU works if you do not use a tested gcc version. Look at
45 'configure' and 'Makefile' if you want to make a different gcc
46 version.
47
48 host      gcc      binutils      glibc    linux
49 -------------------------------------------------------
50 x86       2.95.2   2.13.2        2.1.3    2.4.18
51
52 PowerPC   2.95.4   2.12.90.0.1   2.2.5    2.4.20-pre2
53
54 Alpha     3.3 [1]  2.14.90.0.4   2.2.5    xxx
55
56
57 [1] QEMU cannot work for gcc version < 3.3 on Alpha.
58
59 Documentation
60 -------------
61
62 Read the documentation in qemu-doc.html.
63
64
65 Fabrice Bellard.