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