diff --git a/man/virt-xml.pod b/man/virt-xml.pod index a98ace70..b884d722 100644 --- a/man/virt-xml.pod +++ b/man/virt-xml.pod @@ -139,12 +139,20 @@ If the specified domain is running, attempt to alter the running VM configuratio Keep in mind, most XML properties and devices do not support live update operations, so don't expect it to succeed in all cases. -Note that --update implies --define: it can't be used in isolation. +By default this also implies B<--define>. =item B<--define> Define the requested XML change. This is typically the default if no output option is specified, but if a --print option is specified, --define is required to force the change. +=item B<--no-define> + +Explicitly do not define the XML. For example if you only want to alter the runtime state of a VM, combine this with B<--update>. + +=item B<--start> + +Start the VM after performing the requeseted changes. If combined with --no-define, this will create transient VM boot with the requested changes. + =item B<--print-diff> Print the generated XML change in unified diff format. If only this output option is specified, all other output options are disabled and no persistent change is made. @@ -204,19 +212,39 @@ variants. =item B<--cpu> -=item B<--security> +=item B<--iothreads> + +=item B<--seclabel> + +=item B<--cputune> =item B<--numatune> +=item B<--memtune> + +=item B<--blkiotune> + +=item B<--memorybacking> + =item B<--features> =item B<--clock> =item B<--pm> +=item B<--events> + +=item B<--resources> + +=item B<--sysinfo> + +=item B<--qemu-commandline> + +=item B<--launchSecurity> + =item B<--boot> -=item B<--filesystem> +=item B<--idmap> =item B<--controller> @@ -232,6 +260,8 @@ variants. =item B<--hostdev> +=item B<--filesystem> + =item B<--sound> =item B<--watchdog> @@ -252,8 +282,6 @@ variants. =item B<--memdev> -=item B<--qemu-commandline> - These options alter the XML for a single class of XML elements. More complete documentation is found in L. Generally these options map pretty straightforwardly to the libvirt XML, documented at L @@ -379,6 +407,9 @@ Add qemu command line passthrough: # virt-xml f25 --edit --confirm --qemu-commandline="-device FOO" +Use boot device 'network' for a single transient boot: + + # virt-xml myvm --no-define --start --edit --boot network =head1 CAVEATS