README 1.96 KB
Newer Older
bellard's avatar
bellard committed
1
2
3
4
5
6
7
8
The QEMU x86 emulator
---------------------

INSTALLATION
------------

Type 

bellard's avatar
update    
bellard committed
9
    ./configure --interp-prefix=/usr/local/qemu-i386
bellard's avatar
bellard committed
10
11
12
13
14
15
16
17
    make

to build qemu and libqemu.a.

Type

    make install

18
to install QEMU in /usr/local/bin
bellard's avatar
bellard committed
19

20
21
22
23
24
25
* 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
bellard's avatar
update    
bellard committed
26
(qemu-XXX-i386-glibc21.tar.gz on the qemu web page). Ensure that
bellard's avatar
bellard committed
27
28
29
30
31
LD_LIBRARY_PATH is not set:

    unset LD_LIBRARY_PATH 

Then you can launch the precompiled 'ls' x86 executable:
32

bellard's avatar
update    
bellard committed
33
    ./qemu /usr/local/qemu-i386/bin/ls-i386
34
35
36
37

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.
bellard's avatar
bellard committed
38

bellard's avatar
bellard committed
39
40
41
42
43
44
45
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
bellard's avatar
update    
bellard committed
46
version work.
bellard's avatar
bellard committed
47

bellard's avatar
bellard committed
48
49
50
51
52
host      gcc      binutils      glibc    linux       distribution
----------------------------------------------------------------------
x86       2.95.2   2.13.2        2.1.3    2.4.18           
          3.2      2.13.2        2.1.3    2.4.18
          2.96     2.11.93.0.2   2.2.5    2.4.18      Red Hat 7.3
bellard's avatar
bellard committed
53

bellard's avatar
bellard committed
54
PowerPC   2.95.4   2.12.90.0.1   2.2.5    2.4.20-pre2 Debian 3.0
bellard's avatar
bellard committed
55

bellard's avatar
bellard committed
56
Alpha     3.3 [1]  2.14.90.0.4   2.2.5    2.2.20 [2]  Debian 3.0
bellard's avatar
bellard committed
57

bellard's avatar
bellard committed
58
Sparc32   2.95.4   2.12.90.0.1   2.2.5    2.4.18      Debian 3.0
bellard's avatar
bellard committed
59

bellard's avatar
bellard committed
60
ARM       2.95.4   2.12.90.0.1   2.2.5    2.4.9 [3]   Debian 3.0
bellard's avatar
update    
bellard committed
61
62
63
64
65

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

bellard's avatar
bellard committed
68
69
70
71
72
73
74
Documentation
-------------

Read the documentation in qemu-doc.html.


Fabrice Bellard.