External/libvirt
1
0
Fork 0
mirror of https://gitlab.com/libvirt/libvirt.git synced 2025-02-22 11:22:23 +00:00
Code Issues Packages Projects Releases Wiki Activity

virsh: man: Describe the 'create' command a bit more

Browse Source 
So we refer to the terms 'persistent' and 'transient' across the whole
man page, without describing it further, but more importantly, how the
create command affects it, i.e. explicitly stating that domain created
via the 'create' command are going to be transient or persistent,
depending on whether there is an existing persistent domain with a
matching <name> and <uuid>, in which case it will remain persistent, but
will run using a one-time configuration, otherwise it's going to be
transient and will vanish once destroyed.

Signed-off-by: Erik Skultety <eskultet@redhat.com>
This commit is contained in:
Erik Skultety 2017-09-08 14:52:44 +02:00
parent 776b9ac594
commit b616ec65e2
1 changed files with 26 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

32
tools/virsh.pod
View File

@ -640,9 +640,14 @@ sessions, such as in a case of a broken connection.
Create a domain from an XML <file>. Optionally, I<--validate> option can be Create a domain from an XML <file>. Optionally, I<--validate> option can be
passed to validate the format of the input XML file against an internal RNG passed to validate the format of the input XML file against an internal RNG
schema (identical to using L<virt-xml-validate(1)> tool). An easy way to create schema (identical to using L<virt-xml-validate(1)> tool). Domains created using
the XML <file> is to use the B<dumpxml> command to obtain the definition of a this command are going to be either transient (temporary ones that will vanish
pre-existing guest. The domain will be paused if the I<--paused> option is used once destroyed) or existing persistent domains that will run with one-time use
configuration, leaving the persistent XML untouched (this can come handy during
an automated testing of various configurations all based on the original XML).
See the B<Example> section for usage demonstration.
The domain will be paused if the I<--paused> option is used
and supported by the driver; otherwise it will be running. If I<--console> is and supported by the driver; otherwise it will be running. If I<--console> is
requested, attach to the console after creation. requested, attach to the console after creation.
If I<--autodestroy> is requested, then the guest will be automatically If I<--autodestroy> is requested, then the guest will be automatically
@ -656,9 +661,24 @@ is only supported with container based virtualization.
B<Example> B<Example>
virsh dumpxml <domain> > domain.xml 1) prepare a template from an existing domain (skip directly to 3a if writing
vi domain.xml (or make changes with your other text editor) one from scratch)
virsh create domain.xml
# virsh dumpxml <domain> > domain.xml
2) edit the template using an editor of your choice and:
a) DO CHANGE! <name> and <uuid> (<uuid> can also be removed), or
b) DON'T CHANGE! either <name> or <uuid>
# $EDITOR domain.xml
3) create a domain from domain.xml, depending on whether following 2a or 2b
respectively:
a) the domain is going to be transient
b) an existing persistent domain will run with a modified one-time
configuration
# virsh create domain.xml
=item B<define> I<FILE> [I<--validate>] =item B<define> I<FILE> [I<--validate>]