From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from eggs.gnu.org ([208.118.235.92]:42143) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1UN1zu-0006U9-2m for qemu-devel@nongnu.org; Tue, 02 Apr 2013 10:15:40 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1UN1zs-0008IY-M1 for qemu-devel@nongnu.org; Tue, 02 Apr 2013 10:15:37 -0400 Received: from mail-ye0-f182.google.com ([209.85.213.182]:62091) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1UN1zs-0008IS-Id for qemu-devel@nongnu.org; Tue, 02 Apr 2013 10:15:36 -0400 Received: by mail-ye0-f182.google.com with SMTP id r5so59345yen.27 for ; Tue, 02 Apr 2013 07:15:36 -0700 (PDT) Sender: fluxion From: Michael Roth Date: Tue, 2 Apr 2013 09:13:12 -0500 Message-Id: <1364911993-31042-5-git-send-email-mdroth@linux.vnet.ibm.com> In-Reply-To: <1364911993-31042-1-git-send-email-mdroth@linux.vnet.ibm.com> References: <1364911993-31042-1-git-send-email-mdroth@linux.vnet.ibm.com> Subject: [Qemu-devel] [PATCH 4/5] qga schema: document generic QERR_UNSUPPORTED List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , To: qemu-devel@nongnu.org Cc: aliguori@us.ibm.com, lersek@redhat.com, lilei@linux.vnet.ibm.com, lcapitulino@redhat.com From: Laszlo Ersek Part of the wording was shamelessly stolen from Michael Roth's email. Suggested-by: Michael Roth Signed-off-by: Laszlo Ersek Reviewed-by: Eric Blake Reviewed-by: Michael Roth Signed-off-by: Michael Roth --- 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