README 1.49 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
46
47
48
49
50
51
52
53
54
55
56
57
58
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.

bellard's avatar
bellard committed
59
60
61
62
63
64
65
Documentation
-------------

Read the documentation in qemu-doc.html.


Fabrice Bellard.