[libvirt] [v5][PATCH 4/4] docs: Add documentation for compat mode.

[Michal Privoznik]

On 31.10.2014 10:54, Prerna Saxena wrote:
>
>>From dd917ef27269bc3a9af2294212b088f838792315 Mon Sep 17 00:00:00 2001
> From: Prerna Saxena <prerna at linux.vnet.ibm.com>
> Date: Fri, 31 Oct 2014 15:13:16 +0530
> Subject: [PATCH 4/4] docs: Add documentation for compat mode.
>
> Add documentation to explain how compat-mode can be invoked with libvirt
> running on PowerPC architecture.
>
> Signed-off-by: Prerna Saxena <prerna at linux.vnet.ibm.com>
> ---
>   docs/formatdomain.html.in | 15 ++++++++++++++-
>   1 file changed, 14 insertions(+), 1 deletion(-)
>
> diff --git a/docs/formatdomain.html.in b/docs/formatdomain.html.in
> index 0099ce7..ded9b90 100644
> --- a/docs/formatdomain.html.in
> +++ b/docs/formatdomain.html.in
> @@ -1047,7 +1047,20 @@
>             (such as CPUID level) that don't work. Until these issues are fixed,
>             it's a good idea to avoid using <code>host-model</code> and use
>             <code>custom</code> mode with just the CPU model from host
> -          capabilities XML.</dd>
> +          capabilities XML.
> +          <span class="since">(Since 1.2.10)</span>.PowerISA allows

s/\./. /

> +          processors to run VMs in binary compatibility mode supporting an
> +          older version of ISA.  Libvirt on PowerPC architecture uses the
> +          <code>host-model</code> to signify a guest mode CPU running in
> +          binary compatibility mode. Example:
> +          When a user needs a power7 VM to run in compatibility mode
> +          on a Power8 host, this can be described in XML as follows :
> +<pre>
> +  <cpu mode='host-model'>
> +    <model>power7</model>
> +  </cpu>
> +  ...</pre>
> +          </dd>
>             <dt><code>host-passthrough</code></dt>
>             <dd>With this mode, the CPU visible to the guest should be exactly
>             the same as the host CPU even in the aspects that libvirt does not
>

Michal