README

   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   2.95.4   2.12.90.0.1   2.2.5    2.4.20-pre2 Debian 3.0
  56
  57 Alpha     3.3 [1]  2.14.90.0.4   2.2.5    2.2.20 [2]  Debian 3.0
  58
  59 Sparc32   2.95.4   2.12.90.0.1   2.2.5    2.4.18      Debian 3.0
  60
  61 ARM       2.95.4   2.12.90.0.1   2.2.5    2.4.9 [3]   Debian 3.0
  62
  63 [1] On Alpha, QEMU needs the gcc 'visibility' attribute only available
  64     for gcc version >= 3.3.
  65 [2] Linux >= 2.4.20 is necessary for precise exception support
  66     (untested).
  67 [3] 2.4.9-ac10-rmk2-np1-cerf2
  68
  69 Documentation
  70 -------------
  71
  72 Read the documentation in qemu-doc.html.
  73
  74
  75 Fabrice Bellard.