docs: Add some actual About text to about/index.rst
[qemu.git] / docs / about / index.rst
blob689a9861dc352d2795b456b10813b1386800d617
1 About QEMU
2 ==========
4 QEMU is a generic and open source machine emulator and virtualizer.
6 QEMU can be used in several different ways. The most common is for
7 "system emulation", where it provides a virtual model of an
8 entire machine (CPU, memory and emulated devices) to run a guest OS.
9 In this mode the CPU may be fully emulated, or it may work with
10 a hypervisor such as KVM, Xen, Hax or Hypervisor.Framework to
11 allow the guest to run directly on the host CPU.
13 The second supported way to use QEMU is "user mode emulation",
14 where QEMU can launch processes compiled for one CPU on another CPU.
15 In this mode the CPU is always emulated.
17 QEMU also provides a number of standalone commandline utilities,
18 such as the `qemu-img` disk image utility that allows you to create,
19 convert and modify disk images.
21 .. toctree::
22    :maxdepth: 2
24    build-platforms
25    deprecated
26    removed-features
27    license