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> --- qga/qapi-schema.json | 11 +++++++++++ 1 files changed, 11 insertions(+), 0 deletions(-)
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.1