06905f6402
Use a standard heading format for the index.rst file in a directory. Using overlines makes it clear that individual documents can use e.g. === for chapter titles and --- for section titles, as suggested in the Linux kernel guidelines[1]. They could do it anyway, because documents included in a toctree are parsed separately and therefore are not tied to the same conventions for headings. However, keeping some consistency is useful since sometimes files are included from multiple places. [1] https://www.kernel.org/doc/html/latest/doc-guide/sphinx.html Reviewed-by: Peter Maydell <peter.maydell@linaro.org> Signed-off-by: Paolo Bonzini <pbonzini@redhat.com>
29 lines
912 B
ReStructuredText
29 lines
912 B
ReStructuredText
----------
|
|
About QEMU
|
|
----------
|
|
|
|
QEMU is a generic and open source machine emulator and virtualizer.
|
|
|
|
QEMU can be used in several different ways. The most common is for
|
|
"system emulation", where it provides a virtual model of an
|
|
entire machine (CPU, memory and emulated devices) to run a guest OS.
|
|
In this mode the CPU may be fully emulated, or it may work with
|
|
a hypervisor such as KVM, Xen, Hax or Hypervisor.Framework to
|
|
allow the guest to run directly on the host CPU.
|
|
|
|
The second supported way to use QEMU is "user mode emulation",
|
|
where QEMU can launch processes compiled for one CPU on another CPU.
|
|
In this mode the CPU is always emulated.
|
|
|
|
QEMU also provides a number of standalone commandline utilities,
|
|
such as the ``qemu-img`` disk image utility that allows you to create,
|
|
convert and modify disk images.
|
|
|
|
.. toctree::
|
|
:maxdepth: 2
|
|
|
|
build-platforms
|
|
deprecated
|
|
removed-features
|
|
license
|