projects / qemu.git / blame
| Commit | Line | Data |
|---|---|---|
| 3ef693a0 FB |
1 | The QEMU x86 emulator |
| 2 | --------------------- | |
| 3 | ||
| 4 | INSTALLATION | |
| 5 | ------------ | |
| 6 | ||
| 7 | Type | |
| 8 | ||
| 1eb87257 | 9 | ./configure --interp-prefix=/usr/local/qemu-i386 |
| 3ef693a0 FB |
10 | make |
| 11 | ||
| 12 | to build qemu and libqemu.a. | |
| 13 | ||
| 14 | Type | |
| 15 | ||
| 16 | make install | |
| 17 | ||
| d691f669 | 18 | to install QEMU in /usr/local/bin |
| 3ef693a0 | 19 | |
| d691f669 FB |
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 | |
| 1eb87257 | 26 | (qemu-XXX-i386-glibc21.tar.gz on the qemu web page). Ensure that |
| 644c433c FB |
27 | LD_LIBRARY_PATH is not set: |
| 28 | ||
| 29 | unset LD_LIBRARY_PATH | |
| 30 | ||
| 31 | Then you can launch the precompiled 'ls' x86 executable: | |
| d691f669 | 32 | |
| 500dab07 | 33 | ./qemu /usr/local/qemu-i386/bin/ls-i386 |
| d691f669 FB |
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. | |
| 3ef693a0 | 38 | |
| c1db2eb8 FB |
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 | ||
| 3ef693a0 FB |
59 | Documentation |
| 60 | ------------- | |
| 61 | ||
| 62 | Read the documentation in qemu-doc.html. | |
| 63 | ||
| 64 | ||
| 65 | Fabrice Bellard. |