[Qemu-devel] [PATCH 32/36] qmp: update qmp-spec about async capability

[marcandre . lureau]

From: Marc-André Lureau <address@hidden>

Signed-off-by: Marc-André Lureau <address@hidden>
---
 docs/qmp/qmp-spec.txt | 17 +++++++++++++++--
 1 file changed, 15 insertions(+), 2 deletions(-)

diff --git a/docs/qmp/qmp-spec.txt b/docs/qmp/qmp-spec.txt
index 4c28cd9..f1af7f7 100644
--- a/docs/qmp/qmp-spec.txt
+++ b/docs/qmp/qmp-spec.txt
@@ -83,9 +83,22 @@ The greeting message format is:
 2.2.1 Capabilities
 ------------------
 
-As of the date this document was last revised, no server or client
-capability strings have been defined.
+- "async"
 
+If both the server and the client have the "async" capability, then
+the client is allowed to send async commands. An async command is a
+regular command with the "id" member mandatory (see 2.3), but the
+response may be delayed.
+
+The client must match the incoming responses with the "id" member
+associated with the command.
+
+The client is allowed to make requests while previous requests are
+pending. The responses may come out of order.
+
+When a client is disconnected, the pending commands are not
+necessarily cancelled. However, future clients will not get replies
+from commands they didn't make.
 
 2.3 Issuing Commands
 --------------------
-- 
2.4.3