From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from eggs.gnu.org ([140.186.70.92]:36180) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RW4Ra-0005R5-GW for qemu-devel@nongnu.org; Thu, 01 Dec 2011 06:04:54 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1RW4RU-0007UM-Sl for qemu-devel@nongnu.org; Thu, 01 Dec 2011 06:04:46 -0500 Received: from mail-ee0-f45.google.com ([74.125.83.45]:38921) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RW4RU-0007UB-KI for qemu-devel@nongnu.org; Thu, 01 Dec 2011 06:04:40 -0500 Received: by eeba50 with SMTP id a50so1006953eeb.4 for ; Thu, 01 Dec 2011 03:04:39 -0800 (PST) Date: Thu, 1 Dec 2011 11:04:36 +0000 From: Stefan Hajnoczi Message-ID: <20111201110436.GC31730@stefanha-thinkpad.localdomain> References: <1322687028-29714-1-git-send-email-aliguori@us.ibm.com> <1322687028-29714-11-git-send-email-aliguori@us.ibm.com> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <1322687028-29714-11-git-send-email-aliguori@us.ibm.com> Subject: Re: [Qemu-devel] [PATCH 10/18] qom: qom_{get,set} monitor commands List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , To: Anthony Liguori Cc: Kevin Wolf , Peter Maydell , Stefan Hajnoczi , Jan Kiszka , qemu-devel@nongnu.org, Markus Armbruster , Luiz Capitulino On Wed, Nov 30, 2011 at 03:03:40PM -0600, Anthony Liguori wrote: > +## > +# @qom-get: > +# > +# This command will get a property from a device model path and return the > +# value. > +# > +# @path: The path within the device model. There are two forms of supported > +# paths--absolute and partial paths. > +# > +# Absolute paths are derived from the root device and can follow child<> > +# or link<> properties. Since they can follow link<> properties, they > +# can be arbitrarily long. Absolute paths look like absolute filenames > +# and are prefixed with a leading slash. > +# > +# Partial paths are look like relative filenames. They do not begin s/are// > +# with a prefix. The matching rules for partial paths are subtle but > +# designed to make specifying devices easy. At each level of the > +# composition tree, the partial path is matched as an absolute path. > +# The first match is not returned. At least two matches are searched > +# for. A successful result is only returned if only one match is > +# founded. If more than one match is found, a flag is return to s/founded/found/