commit 1e8b4a4bd9a8e2496fae0d7921ce58f23a9ab0b7
Author: W. David Ashley <w.david.ashley(a)gmail.com>
Date: Tue Jun 30 08:45:50 2015 -0500
Provisioning and Starting section in the Guest Domains chapter:
- updated the verbage from C references to Python references.
en-US/Guest_Domains.xml | 34 ++++++++++++++++++++++++----------
1 files changed, 24 insertions(+), 10 deletions(-)
---
diff --git a/en-US/Guest_Domains.xml b/en-US/Guest_Domains.xml
index 943667d..a02237a 100644
--- a/en-US/Guest_Domains.xml
+++ b/en-US/Guest_Domains.xml
@@ -238,15 +238,15 @@
<title>Methods For Provisioning</title>
<para>
- There are up to three APIs involved in provisioning guests.
- The <literal>virDomainCreateXML</literal> command will
create
+ There are up to three methods involved in provisioning guests.
+ The <literal>createXML</literal> method will create
and immediately boot a new transient guest domain. When this
guest domain shuts down, all trace of it will disappear. The
- <literal>virDomainDefineXML</literal> command will store
the
- configuration for a persistent guest domain. The
<literal>virDomainCreate</literal>
- command will boot a previously defined guest domain
+ <literal>defineXML</literal> method will store the
+ configuration for a persistent guest domain. The
<literal>create</literal>
+ method will boot a previously defined guest domain
from its persistent configuration. One important thing to
- note, is that the <literal>virDomainDefineXML</literal>
command
+ note, is that the <literal>defineXML</literal> command
can be used to turn a previously booted transient guest domain,
into a persistent domain. This can be useful for some provisioning
scenarios that will be illustrated later.
@@ -254,13 +254,27 @@
<section
id="libvirt_application_development_guide_using_python-Guest_Domains-Lifecycle-Provisioning-apis-Booting_Transient_Domain">
<title>Booting a Transient Guest Domain</title>
-
<para>
To boot a transient guest domain, simply requires a connection
to
libvirt and a string containing the XML document describing the
- required guest configuration. The following example assumes that
- <literal>conn</literal> is an instance of the
<literal>virConnectPtr</literal>
- object.
+ required guest configuration and a flag that controls the startup
+ of the domain.
+ </para>
+
+ <para>
+ If the VIR_DOMAIN_START_PAUSED flag is set, the guest domain
+ will be started, but its CPUs will remain paused. The CPUs
+ can later be manually started using the
<literal>resume</literal>
+ method.
+ </para>
+
+ <para>
+ If the VIR_DOMAIN_START_AUTODESTROY flag is set, the guest
+ domain will be automatically destroyed when the
<literal>virConnect</literal>
+ object is finally released. This will also happen if the
+ client application crashes or loses its connection to the
+ libvirtd daemon. Any domains marked for auto destroy will
+ block attempts at migration, save-to-file, or snapshots.
</para>
<example>
Show replies by date