summaryrefslogtreecommitdiff
path: root/qapi
diff options
context:
space:
mode:
authorMarc-André Lureau <marcandre.lureau@redhat.com>2016-06-23 14:17:31 +0200
committerMarkus Armbruster <armbru@redhat.com>2017-01-16 09:19:46 +0100
commit12a21b73cbe607abdd1c5dabb2c4fbdbf77ba7dd (patch)
tree89302bbd0a2b588ace7ef384c1dd5938e59c2701 /qapi
parente1f34cb209109039cbc1d5b11dce85e5289db872 (diff)
downloadqemu-12a21b73cbe607abdd1c5dabb2c4fbdbf77ba7dd.tar.gz
qmp-commands: move 'drive-mirror' doc to schema
Signed-off-by: Marc-André Lureau <marcandre.lureau@redhat.com> Signed-off-by: Markus Armbruster <armbru@redhat.com>
Diffstat (limited to 'qapi')
-rw-r--r--qapi/block-core.json17
1 files changed, 16 insertions, 1 deletions
diff --git a/qapi/block-core.json b/qapi/block-core.json
index b37a8b761a..546cb8952b 100644
--- a/qapi/block-core.json
+++ b/qapi/block-core.json
@@ -1444,7 +1444,12 @@
##
# @drive-mirror:
#
-# Start mirroring a block device's writes to a new destination.
+# Start mirroring a block device's writes to a new destination. target
+# specifies the target of the new image. If the file exists, or if it
+# is a device, it will be used as the new destination for writes. If
+# it does not exist, a new file will be created. format specifies the
+# format of the mirror image, default is to probe if mode='existing',
+# else the format of the source.
#
# See DriveMirror for parameter descriptions
#
@@ -1452,6 +1457,16 @@
# If @device is not a valid block device, GenericError
#
# Since: 1.3
+#
+# Example:
+#
+# -> { "execute": "drive-mirror",
+# "arguments": { "device": "ide-hd0",
+# "target": "/some/place/my-image",
+# "sync": "full",
+# "format": "qcow2" } }
+# <- { "return": {} }
+#
##
{ 'command': 'drive-mirror', 'boxed': true,
'data': 'DriveMirror' }