From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from eggs.gnu.org ([208.118.235.92]:35444) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1UGZ1H-0006Sa-7I for qemu-devel@nongnu.org; Fri, 15 Mar 2013 14:06:25 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1UGZ1E-0003QL-4X for qemu-devel@nongnu.org; Fri, 15 Mar 2013 14:06:19 -0400 Received: from mx1.redhat.com ([209.132.183.28]:38957) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1UGZ1D-0003QF-Pn for qemu-devel@nongnu.org; Fri, 15 Mar 2013 14:06:16 -0400 From: Laszlo Ersek Date: Fri, 15 Mar 2013 19:07:51 +0100 Message-Id: <1363370871-10537-3-git-send-email-lersek@redhat.com> In-Reply-To: <1363370871-10537-1-git-send-email-lersek@redhat.com> References: <1363370871-10537-1-git-send-email-lersek@redhat.com> Subject: [Qemu-devel] [PATCH 2/2] qga schema: document generic QERR_UNSUPPORTED List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , To: qemu-devel@nongnu.org, mdroth@linux.vnet.ibm.com, eblake@redhat.com Part of the wording was shamelessly stolen from Michael Roth's email. Suggested-by: Michael Roth Signed-off-by: Laszlo Ersek --- 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