Statistics
| Branch: | Revision:

root / README @ 17383a2a

History | View | Annotate | Download (2.1 kB)

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
          3.2.2    2.13.90.0.18  2.3.2    2.4.20      Red Hat 9
54

    
55
PowerPC   3.3 [4]  2.13.90.0.18  2.3.1    2.4.20briq
56
          3.2
57

    
58
Alpha     3.3 [1]  2.14.90.0.4   2.2.5    2.2.20 [2]  Debian 3.0
59

    
60
Sparc32   2.95.4   2.12.90.0.1   2.2.5    2.4.18      Debian 3.0
61

    
62
ARM       2.95.4   2.12.90.0.1   2.2.5    2.4.9 [3]   Debian 3.0
63

    
64
[1] On Alpha, QEMU needs the gcc 'visibility' attribute only available
65
    for gcc version >= 3.3.
66
[2] Linux >= 2.4.20 is necessary for precise exception support
67
    (untested).
68
[3] 2.4.9-ac10-rmk2-np1-cerf2
69

    
70
[4] gcc 2.95.x generates invalid code when using too many register
71
variables. You must use gcc 3.x on PowerPC.
72

    
73
Documentation
74
-------------
75

    
76
Read the documentation in qemu-doc.html.
77

    
78

    
79
Fabrice Bellard.