summary refs log tree commit diff stats
path: root/docs/qmp-commands.txt
diff options
context:
space:
mode:
authorKevin Wolf <kwolf@redhat.com>2016-09-20 13:38:43 +0200
committerKevin Wolf <kwolf@redhat.com>2016-09-23 13:36:10 +0200
commitb33945cfffcc3f847122dbf5db00fff28161c593 (patch)
treef9504d35b88ebaa74884d5d3827cacad8511414c /docs/qmp-commands.txt
parent9680caee0fa530726809bc72d44e127ae676e251 (diff)
downloadfocaccia-qemu-b33945cfffcc3f847122dbf5db00fff28161c593.tar.gz
focaccia-qemu-b33945cfffcc3f847122dbf5db00fff28161c593.zip
block: Accept device model name for blockdev-open/close-tray
In order to remove the need for BlockBackend names in the external API,
we want to allow qdev device names in all device related commands.

This converts blockdev-open/close-tray to accept a qdev device name.

Signed-off-by: Kevin Wolf <kwolf@redhat.com>
Diffstat (limited to 'docs/qmp-commands.txt')
-rw-r--r--docs/qmp-commands.txt12
1 files changed, 8 insertions, 4 deletions
diff --git a/docs/qmp-commands.txt b/docs/qmp-commands.txt
index acebeb3954..9e230f51f7 100644
--- a/docs/qmp-commands.txt
+++ b/docs/qmp-commands.txt
@@ -3228,7 +3228,9 @@ which no such event will be generated, these include:
 
 Arguments:
 
-- "device": block device name (json-string)
+- "device": block device name (deprecated, use @id instead)
+            (json-string, optional)
+- "id": the name or QOM path of the guest device (json-string, optional)
 - "force": if false (the default), an eject request will be sent to the guest if
            it has locked the tray (and the tray will not be opened immediately);
            if true, the tray will be opened regardless of whether it is locked
@@ -3237,7 +3239,7 @@ Arguments:
 Example:
 
 -> { "execute": "blockdev-open-tray",
-     "arguments": { "device": "ide1-cd0" } }
+     "arguments": { "id": "ide0-1-0" } }
 
 <- { "timestamp": { "seconds": 1418751016,
                     "microseconds": 716996 },
@@ -3258,12 +3260,14 @@ If the tray was already closed before, this will be a no-op.
 
 Arguments:
 
-- "device": block device name (json-string)
+- "device": block device name (deprecated, use @id instead)
+            (json-string, optional)
+- "id": the name or QOM path of the guest device (json-string, optional)
 
 Example:
 
 -> { "execute": "blockdev-close-tray",
-     "arguments": { "device": "ide1-cd0" } }
+     "arguments": { "id": "ide0-1-0" } }
 
 <- { "timestamp": { "seconds": 1418751345,
                     "microseconds": 272147 },