more compiler tests
[sdk/emulator/qemu.git] / 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 work.
47
48 host      gcc      binutils      glibc    linux       distribution
49 ----------------------------------------------------------------------
50 x86       2.95.2   2.13.2        2.1.3    2.4.18           
51           3.2      2.13.2        2.1.3    2.4.18
52           2.96     2.11.93.0.2   2.2.5    2.4.18      Red Hat 7.3
53
54 PowerPC   2.95.4   2.12.90.0.1   2.2.5    2.4.20-pre2 Debian 3.0
55
56 Alpha     3.3 [1]  2.14.90.0.4   2.2.5    2.2.20 [2]  Debian 3.0
57
58 Sparc32   2.95.4   2.12.90.0.1   2.2.5    2.4.18      Debian 3.0
59
60 ARM       2.95.4   2.12.90.0.1   2.2.5    2.4.9 [3]   Debian 3.0
61
62 [1] On Alpha, QEMU needs the gcc 'visibility' attribute only available
63     for gcc version >= 3.3.
64 [2] Linux >= 2.4.20 is necessary for precise exception support
65     (untested).
66 [3] 2.4.9-ac10-rmk2-np1-cerf2
67
68 Documentation
69 -------------
70
71 Read the documentation in qemu-doc.html.
72
73
74 Fabrice Bellard.