aboutsummaryrefslogtreecommitdiff
path: root/docs/about/index.rst
diff options
context:
space:
mode:
authorPeter Maydell <peter.maydell@linaro.org>2021-07-05 10:55:45 +0100
committerPeter Maydell <peter.maydell@linaro.org>2021-07-18 10:59:47 +0100
commit4a43fa3af926bb2ceef8f7ed188a41c70e0e8477 (patch)
tree99cde2fa2e641641f5d1cceb9587cae5c214073b /docs/about/index.rst
parentf347839258a1ace57d0b59e89bf01352b8d1c13b (diff)
downloadqemu-4a43fa3af926bb2ceef8f7ed188a41c70e0e8477.zip
qemu-4a43fa3af926bb2ceef8f7ed188a41c70e0e8477.tar.gz
qemu-4a43fa3af926bb2ceef8f7ed188a41c70e0e8477.tar.bz2
docs: Add some actual About text to about/index.rst
Add some text to About to act as a brief introduction to the QEMU manual and to make the about page a bit less of an abrupt start to it. Signed-off-by: Peter Maydell <peter.maydell@linaro.org> Acked-by: Markus Armbruster <armbru@redhat.com> Reviewed-by: Daniel P. Berrangé <berrange@redhat.com> Message-id: 20210705095547.15790-6-peter.maydell@linaro.org
Diffstat (limited to 'docs/about/index.rst')
-rw-r--r--docs/about/index.rst17
1 files changed, 17 insertions, 0 deletions
diff --git a/docs/about/index.rst b/docs/about/index.rst
index cd44456..689a986 100644
--- a/docs/about/index.rst
+++ b/docs/about/index.rst
@@ -1,6 +1,23 @@
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