From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from eggs.gnu.org ([140.186.70.92]:36354) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1QzXSN-0004a5-BH for qemu-devel@nongnu.org; Fri, 02 Sep 2011 13:23:08 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1QzXSM-0008FS-Cr for qemu-devel@nongnu.org; Fri, 02 Sep 2011 13:23:07 -0400 Received: from mx1.redhat.com ([209.132.183.28]:41114) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1QzXSL-0008FM-W7 for qemu-devel@nongnu.org; Fri, 02 Sep 2011 13:23:06 -0400 Date: Fri, 2 Sep 2011 14:23:02 -0300 From: Luiz Capitulino Message-ID: <20110902142302.506bf6d0@doriath> In-Reply-To: References: Mime-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit Subject: Re: [Qemu-devel] [PATCH 3/6] QMP: Reserve namespace for complex object classes List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , To: Jan Kiszka Cc: Anthony Liguori , qemu-devel On Fri, 26 Aug 2011 16:48:13 +0200 Jan Kiszka wrote: > This reserves JSON objects that contain the key '__class__' for QMP-specific > complex objects. First user will be the buffer class. > > CC: Luiz Capitulino > Signed-off-by: Jan Kiszka > --- > QMP/qmp-spec.txt | 16 +++++++++++++--- > 1 files changed, 13 insertions(+), 3 deletions(-) > > diff --git a/QMP/qmp-spec.txt b/QMP/qmp-spec.txt > index 9d30a8c..fa1dd62 100644 > --- a/QMP/qmp-spec.txt > +++ b/QMP/qmp-spec.txt > @@ -146,6 +146,15 @@ The format is: > For a listing of supported asynchronous events, please, refer to the > qmp-events.txt file. > > +2.6 Complex object classes > +-------------------------- > + > +JSON objects that contain the key-value pair '"__class__": json-string' are > +reserved for QMP-specific complex object classes that. QMP specifies which Can I just drop the period or is it misplaced? > +further keys each of these objects include and how they are encoded. > + > +So far, no complex object class is specified. > + > 3. QMP Examples > =============== > > @@ -229,9 +238,10 @@ avoid modifying QMP. Both upstream and downstream need to take care to > preserve long-term compatibility and interoperability. > > To help with that, QMP reserves JSON object member names beginning with > -'__' (double underscore) for downstream use ("downstream names"). This > -means upstream will never use any downstream names for its commands, > -arguments, errors, asynchronous events, and so forth. > +'__' (double underscore) for downstream use ("downstream names"). Downstream > +names MUST NOT end with '__' as this pattern is reserved for QMP-defined JSON > +object classes. Upstream will never use any downstream names for its > +commands, arguments, errors, asynchronous events, and so forth. > > Any new names downstream wishes to add must begin with '__'. To > ensure compatibility with other downstreams, it is strongly