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 | |
| 411bffc4 | 46 | version work. |
| c1db2eb8 | 47 | |
| 844c72ec FB |
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 | |
| 9d0fe224 | 53 | 3.2.2 2.13.90.0.18 2.3.2 2.4.20 Red Hat 9 |
| c1db2eb8 | 54 | |
| 17383a2a FB |
55 | PowerPC 3.3 [4] 2.13.90.0.18 2.3.1 2.4.20briq |
| 56 | 3.2 | |
| c1db2eb8 | 57 | |
| 844c72ec | 58 | Alpha 3.3 [1] 2.14.90.0.4 2.2.5 2.2.20 [2] Debian 3.0 |
| c1db2eb8 | 59 | |
| 844c72ec | 60 | Sparc32 2.95.4 2.12.90.0.1 2.2.5 2.4.18 Debian 3.0 |
| c1db2eb8 | 61 | |
| 844c72ec | 62 | ARM 2.95.4 2.12.90.0.1 2.2.5 2.4.9 [3] Debian 3.0 |
| 411bffc4 FB |
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). | |
| 844c72ec | 68 | [3] 2.4.9-ac10-rmk2-np1-cerf2 |
| c1db2eb8 | 69 | |
| 17383a2a FB |
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 | ||
| 3ef693a0 FB |
73 | Documentation |
| 74 | ------------- | |
| 75 | ||
| 76 | Read the documentation in qemu-doc.html. | |
| 77 | ||
| 78 | ||
| 79 | Fabrice Bellard. |