.. SPDX-License-Identifier: CC-BY-4.0

The Xen Hypervisor documentation
================================

.. note::

   Xen's Sphinx/RST documentation is a work in progress.  The existing
   documentation can be found at https://xenbits.xen.org/docs/

Xen is an open source, bare metal hypervisor.  It runs as the most privileged
piece of software on the system, and shares the resources of the hardware
between virtual machines.  See :doc:`admin-guide/introduction` for an
introduction to a Xen system.

User documentation
------------------

This is documentation for an administrator of a Xen system.  It is intended
for someone who is not necessarily a developer, has installed Xen from their
preferred distribution, and is attempting to run virtual machines and
configure the system.

.. toctree::
   :maxdepth: 2

   admin-guide/index


Guest documentation
-------------------

This documentation concerns the APIs and ABIs available to guests.  It is
intended for OS developers trying to use a Xen feature, and for Xen developers
to avoid breaking things.

.. toctree::
   :maxdepth: 3

   guest-guide/index


Hypervisor developer documentation
----------------------------------

This is documentation for a hypervisor developer.  It is intended for someone
who is building Xen from source, and is running the new hypervisor in some
kind of development environment.

.. toctree::
   :maxdepth: 2

   hypervisor-guide/index
   misc/ci


Unsorted documents
------------------

Documents in need of some rearranging.

.. toctree::
   :maxdepth: 2

   designs/launch/hyperlaunch
   designs/launch/hyperlaunch-devicetree
   misc/xen-makefiles/makefiles
   misra/index
   fusa/index
   misc/cache-coloring


Miscellanea
-----------

.. toctree::

   faq
   glossary
