Re: [Xen-devel] [PATCH] docs/sphinx: Introduction

[Jan Beulich <jbeulich@xxxxxxxx>]

On 07.08.2019 21:41, Andrew Cooper wrote:
> --- /dev/null
> +++ b/docs/glossary.rst
> @@ -0,0 +1,37 @@
> +Glossary
> +========
> +
> +.. Terms should appear in alphabetical order
> +
> +.. glossary::
> +
> +   control domain
> +     A :term:`domain`, commonly dom0, with the permission and responsibility
> +     to create and manage other domains on the system.
> +
> +   domain
> +     A domain is Xen's unit of resource ownership, and generally has at the
> +     minimum some RAM and virtual CPUs.
> +
> +     The terms :term:`domain` and :term:`guest` are commonly used
> +     interchangeably, but they mean subtly different things.
> +
> +     A guest is a single virtual machine.
> +
> +     Consider the case of live migration where, for a period of time, one
> +     guest will be comprised of two domains, while it is in transit.
> +
> +   domid
> +     The numeric identifier of a running :term:`domain`.  It is unique to a
> +     single instance of Xen, used as the identifier in various APIs, and is
> +     typically allocated sequentially from 0.
> +
> +   guest
> +     See :term:`domain`
I think you want to mention the usual distinction here: Dom0 is,
while a domain, commonly not considered a guest.

Everything else looks okay to me, but I can't reasonably address your
RFC aspect.

Jan

_______________________________________________
Xen-devel mailing list
Xen-devel@xxxxxxxxxxxxxxxxxxxx
https://lists.xenproject.org/mailman/listinfo/xen-devel