[Qemu-devel] [PATCH 1/2] QMP: Introduce the documentation for query-qdm

[Miguel Di Ciurcio Filho <miguel.filho@gmail.com>]

---
 qemu-monitor.hx |   68 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 files changed, 68 insertions(+), 0 deletions(-)

diff --git a/qemu-monitor.hx b/qemu-monitor.hx
index 9f62b94..5348899 100644
--- a/qemu-monitor.hx
+++ b/qemu-monitor.hx
@@ -2490,6 +2490,74 @@ STEXI
 show device tree
 @item info qdm
 show qdev device model list
+ETEXI
+SQMP
+query-qdm
+---------
+
+Describe the capabilities of all devices registered with qdev.
+
+The returned output is a list, each element is a json-object describing a single
+device type.
+
+Each json-object contains the following:
+
+- "name": the short name of the device (json-string)
+- "bus": the name of the bus type for the device (json-string)
+- "alias": an alias by which the device is also known (json-string, optional)
+- "description": a long description the device  (json-string, optional)
+- "creatable": whether this device can be created on command line (json-boolean)
+- "props": a list where each element is an json-object that describes a property
+of the device. Each json-object contains the following:
+     - "name": the short name of the property (json-string)
+     - "info": short description of the property (json-string)
+     - "type": the data type of the property value (json-string)
+
+Example:
+
+-> { "execute": "query-qdm" }
+<- {
+      "return": [
+        {
+           "name": "virtio-9p-pci",
+           "creatable": true,
+           "bus": "PCI",
+           "props": [
+             {
+                 "name": "indirect_desc",
+                 "type": "bit",
+                 "info": "on/off"
+             },
+             {
+                 "name": "mount_tag",
+                 "type": "string",
+                 "info": "string"
+             },
+             {
+                 "name": "fsdev",
+                 "type": "string",
+                 "info": "string"
+             }
+           ]
+        },
+        {
+           "name": "virtio-balloon-pci",
+           "creatable": true,
+           "bus": "PCI",
+           "props": [
+             {
+               "name": "indirect_desc",
+               "type": "bit",
+               "info": "on/off"
+             }
+           ]
+        },
+      ....
+    ]
+
+EQMP
+
+STEXI
 @item info roms
 show roms
 @end table
-- 
1.7.1