aboutsummaryrefslogtreecommitdiff
path: root/qapi
diff options
context:
space:
mode:
authorMarc-André Lureau <marcandre.lureau@redhat.com>2016-06-23 14:04:28 +0200
committerMarkus Armbruster <armbru@redhat.com>2017-01-16 09:19:45 +0100
commitb4039d8d23a6729c0206b3b3b14a9cd0bd618b69 (patch)
tree285ffd6a2cabf64d3142090c2c90305fc3073d6d /qapi
parent0dc869cf709368265bb5b7a5fe35b7e3b53a776e (diff)
qmp-commands: move 'blockdev-snapshot-sync' 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.json14
1 files changed, 13 insertions, 1 deletions
diff --git a/qapi/block-core.json b/qapi/block-core.json
index d1bc2e5901..884831943b 100644
--- a/qapi/block-core.json
+++ b/qapi/block-core.json
@@ -1037,7 +1037,9 @@
#
# @node-name: #optional graph node name to generate the snapshot from (Since 2.0)
#
-# @snapshot-file: the target of the new image. A new file will be created.
+# @snapshot-file: the target of the new image. If the file exists, or
+# if it is a device, the snapshot will be created in the existing
+# file/device. Otherwise, a new file will be created.
#
# @snapshot-node-name: #optional the graph node name of the new image (Since 2.0)
#
@@ -1171,6 +1173,16 @@
# If @device is not a valid block device, DeviceNotFound
#
# Since: 0.14.0
+#
+# Example:
+#
+# -> { "execute": "blockdev-snapshot-sync",
+# "arguments": { "device": "ide-hd0",
+# "snapshot-file":
+# "/some/place/my-image",
+# "format": "qcow2" } }
+# <- { "return": {} }
+#
##
{ 'command': 'blockdev-snapshot-sync',
'data': 'BlockdevSnapshotSync' }