[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Qemu-devel] [PATCH v4 5/5] update docs/qmp-full-introspection.txt
From: |
Amos Kong |
Subject: |
[Qemu-devel] [PATCH v4 5/5] update docs/qmp-full-introspection.txt |
Date: |
Thu, 23 Jan 2014 22:46:36 +0800 |
Signed-off-by: Amos Kong <address@hidden>
---
docs/qmp-full-introspection.txt | 38 ++++++++++++++++++++++++++++++++++++++
1 file changed, 38 insertions(+)
diff --git a/docs/qmp-full-introspection.txt b/docs/qmp-full-introspection.txt
index 8ecbc0c..4cb1b9e 100644
--- a/docs/qmp-full-introspection.txt
+++ b/docs/qmp-full-introspection.txt
@@ -8,6 +8,44 @@ information, it returns a range of schema structs, which
contain the
useful metadata to help management to check supported features, QMP
commands detail, etc.
+== Usage ==
+
+Json schema:
+ { 'type': 'NameInfo', 'data': {'*name': 'str'} }
+ { 'command': 'query-name', 'returns': 'NameInfo' }
+
+Execute QMP command:
+
+ { "execute": "query-qmp-schema" }
+
+Returns:
+
+ { "return": [
+ {
+ "name": "query-name",
+ "type": "command",
+ "returns": {
+ "name": "NameInfo",
+ "type": "type",
+ "data": [
+ {
+ "name": "name",
+ "optional": true,
+ "recursive": false,
+ "type": "str"
+ }
+ ]
+ }
+ },
+ ...
+ }
+
+The whole schema information will be returned in one go, it contains
+all the schema entries. It doesn't support to be filtered by type
+or name. Currently it takes about 4 seconds to return about 1.7M string.
+Management only needs to execute this command once after installing
+QEMU package.
+
== 'DataObject' union ==
{ 'union': 'DataObject',
--
1.8.4.2
- [Qemu-devel] [PATCH v4 0/5] QMP full introspection, Amos Kong, 2014/01/23
- [Qemu-devel] [PATCH v4 2/5] qapi: add qapi-introspect.py code generator, Amos Kong, 2014/01/23
- [Qemu-devel] [PATCH v4 1/5] qapi: introduce DataObject to describe dynamic structs, Amos Kong, 2014/01/23
- [Qemu-devel] [PATCH v4 4/5] qmp: full introspection support for QMP, Amos Kong, 2014/01/23
- [Qemu-devel] [PATCH v4 3/5] qobject: introduce qobject_get_str(), Amos Kong, 2014/01/23
- [Qemu-devel] [PATCH v4 5/5] update docs/qmp-full-introspection.txt,
Amos Kong <=
- Re: [Qemu-devel] [PATCH v4 0/5] QMP full introspection, Amos Kong, 2014/01/24