[libvirt] [PATCH 4/4] virsh: Add document for cmdChangeMedia

Osier Yang jyang at redhat.com
Fri Feb 3 09:23:12 UTC 2012

 tools/virsh.pod |   25 +++++++++++++++++++++++++
 1 files changed, 25 insertions(+), 0 deletions(-)

diff --git a/tools/virsh.pod b/tools/virsh.pod
index 28ad422..6ac7d15 100644
--- a/tools/virsh.pod
+++ b/tools/virsh.pod
@@ -1475,6 +1475,31 @@ option can be used to force device update, e.g., to eject a CD-ROM even if it
 is locked/mounted in the domain. See the documentation to learn about libvirt
 XML format for a device.
+=item B<change-media> I<domain-id> I<target> [I<source>] [I<--eject>]
+[I<--insert>] [I<--update>] [I<--current>] [I<--live>] [I<--config>]
+Change media of CDROM or floppy drive. I<target> is the unique target name
+(<target dev='name'/>) of the device. I<source> specifies the path of the media
+to be inserted or updated.
+I<--eject> indicates the media will be ejected.
+I<--insert> indicates the media will be inserted. I<source> must be specified.
+If the device has source (e.g. <source file='media'>), and I<source> is not
+specified, I<--update> is equal to I<--eject>. If the device has no source,
+and I<source> is specified, I<--update> is equal to I<--insert>. If the device
+has source, and I<source> is specified, I<--update> behaves like combination
+of I<--eject> and I<--insert>.
+If I<--live> is specified, alter live configuration of running guest.
+If I<--config> is specified, alter persistent configuration, effect observed
+on next boot.
+I<--current> can be either or both of I<live> and I<config>, depends on
+the hypervisor's implementation.
+Both I<--live> and I<--config> flags may be given, but I<--current> is
+exclusive. If no flag is specified, behavior is different depending
+on hypervisor.
+The I<--force> option can be used to force media changing.

More information about the libvir-list mailing list