From: Laszlo Ersek <ler...@redhat.com> Part of the wording was shamelessly stolen from Michael Roth's email.
Suggested-by: Michael Roth <mdr...@linux.vnet.ibm.com> Signed-off-by: Laszlo Ersek <ler...@redhat.com> Reviewed-by: Eric Blake <ebl...@redhat.com> Reviewed-by: Michael Roth <mdr...@linux.vnet.ibm.com> Signed-off-by: Michael Roth <mdr...@linux.vnet.ibm.com> --- 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
