qemu/README

   1 QEMU is a generic and open source machine emulator and virtualizer.
   2
   3 When used as a machine emulator, QEMU can run OSes and programs made for
   4 one machine (e.g. an ARM board) on a different machine (e.g. your PC).
   5 By using dynamic translation, it achieves very good performances.
   6
   7 qemu (with kvm enabled) achieves near native performances by leveraging
   8 the kvm-kmod modules and executing the guest code directly on the host
   9 CPU.  Slackware provides pre-built 32/64 bit x86 kvm-kmod modules or you
  10 can build different versions with the kvm-kmod package.
  11
  12 By default, this script builds all emulation targets for qemu; if you
  13 prefer to build specific target(s), do this:
  14
  15   TARGETS=arm-softmmu,arm-linux-user,armeb-linux-user ./qemu.SlackBuild
  16
  17 (Refer to qemu documentation for available emulation targets.)
  18
  19 Disable vnc support via:
  20
  21   VNC_ENABLE=no ./qemu.SlackBuild
  22
  23 Audio drivers support defaults to "pa,alsa,oss,sdl" and can be adusted
  24 by running the build script like this:
  25
  26   AUDIODRIVERS="pa,alsa,oss" ./qemu.SlackBuild
  27
  28 We patch the installed udev rules to require membership in "users"
  29 group instead of a custom "kvm" group to use /dev/kvm.  If you prefer
  30 something different, then run the build script like this:
  31
  32   KVMGROUP=group ./qemu.SlackBuild
  33
  34 To have the qemu-bridge-helper installed setuid root, allowing regular
  35 users to use extended networking capabilities, do this:
  36
  37   BRIDGE_HELPER_SETUID=yes ./qemu.SlackBuild
  38
  39 Don't forget to load the 'kvm-intel' or 'kvm-amd' module (depending on
  40 your processor) prior to launching qemu-system-ARCH with kvm enabled.
  41 For older/unmaintained qemu frontends, this build also creates a symlink
  42 to qemu-system-ARCH at /usr/bin/qemu-kvm.
  43
  44 libslirp (user mode networking), libcacard, spice, usbredir,
  45 virglrenderer, libnfs, snappy, device-tree-compiler, glusterfs, and vde2
  46 are optional dependencies.
  47
  48 To enable user mode networking, install libslirp (availale on SBO), then
  49 compile qemu:
  50
  51 SLIRP=yes ./qemu.SlackBuild
  52
  53 libiscsi (to access iSCSI targets directly) is optional dependency,
  54 and will be picked up, if present, during the compilation.
  55
  56 sphinx-rtd-theme and Sphinx (both on SBo) are  optional but required in
  57 order for any of the documentation to be built.
  58
  59 If you wish to emulate ARM, you will want device-tree-compiler.
  60
  61 NOTES:
  62   This version breaks some backward compatibility with earlier versions.
  63   Consult the official changelogs for details.
  64
  65   If there are problems after upgrading with missing or wrong versioned
  66   libraries please try uninstalling any previous versions before
  67   rebuilding a new one.