[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Qemu-devel] [PATCH 4/5] qga schema: document generic QERR_UNSUPPORTED
From: |
Michael Roth |
Subject: |
[Qemu-devel] [PATCH 4/5] qga schema: document generic QERR_UNSUPPORTED |
Date: |
Tue, 2 Apr 2013 09:13:12 -0500 |
From: Laszlo Ersek <address@hidden>
Part of the wording was shamelessly stolen from Michael Roth's email.
Suggested-by: Michael Roth <address@hidden>
Signed-off-by: Laszlo Ersek <address@hidden>
Reviewed-by: Eric Blake <address@hidden>
Reviewed-by: Michael Roth <address@hidden>
Signed-off-by: Michael Roth <address@hidden>
---
qga/qapi-schema.json | 11 +++++++++++
1 file changed, 11 insertions(+)
diff --git a/qga/qapi-schema.json b/qga/qapi-schema.json
index 2af3515..7155b7a 100644
--- a/qga/qapi-schema.json
+++ b/qga/qapi-schema.json
@@ -2,6 +2,17 @@
##
#
+# General note concerning the use of guest agent interfaces:
+#
+# "unsupported" is a higher-level error than the errors that individual
+# commands might document. The caller should always be prepared to receive
+# QERR_UNSUPPORTED, even if the given command doesn't specify it, or doesn't
+# document any failure mode at all.
+#
+##
+
+##
+#
# Echo back a unique integer value, and prepend to response a
# leading sentinel byte (0xFF) the client can check scan for.
#
--
1.7.9.5