|
|
e73cc6 |
From: Prerna Saxena <prerna@linux.vnet.ibm.com>
|
|
|
e73cc6 |
Date: Tue, 4 Nov 2014 23:00:36 +0530
|
|
|
e73cc6 |
Subject: [PATCH] docs: Add documentation for compat mode.
|
|
|
e73cc6 |
|
|
|
e73cc6 |
Add documentation to explain how compat-mode can be invoked with libvirt
|
|
|
e73cc6 |
running on PowerPC architecture.
|
|
|
e73cc6 |
It also mentions that this change is available libvirt 1.2.11 onwards.
|
|
|
e73cc6 |
|
|
|
e73cc6 |
Signed-off-by: Prerna Saxena <prerna@linux.vnet.ibm.com>
|
|
|
e73cc6 |
Reviewed-by: Michal Privoznik <mprivozn@redhat.com>
|
|
|
e73cc6 |
(cherry picked from commit 9265fd19b68d787e478f5e490524da794965a5f1)
|
|
|
e73cc6 |
---
|
|
|
e73cc6 |
docs/formatdomain.html.in | 15 ++++++++++++++-
|
|
|
e73cc6 |
1 file changed, 14 insertions(+), 1 deletion(-)
|
|
|
e73cc6 |
|
|
|
e73cc6 |
diff --git a/docs/formatdomain.html.in b/docs/formatdomain.html.in
|
|
|
e73cc6 |
index 0099ce7..bdaf808 100644
|
|
|
e73cc6 |
--- a/docs/formatdomain.html.in
|
|
|
e73cc6 |
+++ b/docs/formatdomain.html.in
|
|
|
e73cc6 |
@@ -1047,7 +1047,20 @@
|
|
|
e73cc6 |
(such as CPUID level) that don't work. Until these issues are fixed,
|
|
|
e73cc6 |
it's a good idea to avoid using host-model and use
|
|
|
e73cc6 |
custom mode with just the CPU model from host
|
|
|
e73cc6 |
- capabilities XML.
|
|
|
e73cc6 |
+ capabilities XML.
|
|
|
e73cc6 |
+ (Since 1.2.11). PowerISA allows
|
|
|
e73cc6 |
+ processors to run VMs in binary compatibility mode supporting an
|
|
|
e73cc6 |
+ older version of ISA. Libvirt on PowerPC architecture uses the
|
|
|
e73cc6 |
+ host-model to signify a guest mode CPU running in
|
|
|
e73cc6 |
+ binary compatibility mode. Example:
|
|
|
e73cc6 |
+ When a user needs a power7 VM to run in compatibility mode
|
|
|
e73cc6 |
+ on a Power8 host, this can be described in XML as follows :
|
|
|
e73cc6 |
+
|
|
|
e73cc6 |
+ <cpu mode='host-model'>
|
|
|
e73cc6 |
+ <model>power7</model>
|
|
|
e73cc6 |
+ </cpu>
|
|
|
e73cc6 |
+ ...
|
|
|
e73cc6 |
+
|
|
|
e73cc6 |
host-passthrough
|
|
|
e73cc6 |
With this mode, the CPU visible to the guest should be exactly
|
|
|
e73cc6 |
the same as the host CPU even in the aspects that libvirt does not
|