diff mbox

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

Message ID 1443189844-20341-33-git-send-email-marcandre.lureau@redhat.com
State New
Headers show

Commit Message

Marc-André Lureau Sept. 25, 2015, 2:04 p.m. UTC 
From: Marc-André Lureau <marcandre.lureau@redhat.com>

Signed-off-by: Marc-André Lureau <marcandre.lureau@redhat.com>
---
 docs/qmp/qmp-spec.txt | 17 +++++++++++++++--
 1 file changed, 15 insertions(+), 2 deletions(-)
diff mbox

Patch

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
 --------------------