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

--- tools/virsh.pod | 25 +++++++++++++++++++++++++ 1 files changed, 25 insertions(+), 0 deletions(-) diff --git a/tools/virsh.pod b/tools/virsh.pod index 138f886..bd127c6 100644 --- a/tools/virsh.pod +++ b/tools/virsh.pod @@ -1408,6 +1408,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>] +[I<--force>] + +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. + =back =head1 NODEDEV COMMANDS -- 1.7.7.3