From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from eggs.gnu.org ([140.186.70.92]:39143) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RzmmP-0000y8-VR for qemu-devel@nongnu.org; Tue, 21 Feb 2012 05:17:11 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1RzmmL-0000mp-Mq for qemu-devel@nongnu.org; Tue, 21 Feb 2012 05:17:05 -0500 Received: from mx1.redhat.com ([209.132.183.28]:4687) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RzmmL-0000ma-GG for qemu-devel@nongnu.org; Tue, 21 Feb 2012 05:17:01 -0500 Message-ID: <4F436F17.3070400@redhat.com> Date: Tue, 21 Feb 2012 11:16:55 +0100 From: Paolo Bonzini MIME-Version: 1.0 References: <1329819262-4617-1-git-send-email-alexander_barabash@mentor.com> In-Reply-To: <1329819262-4617-1-git-send-email-alexander_barabash@mentor.com> Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: 7bit Subject: Re: [Qemu-devel] [PATCH] qom: Document ways to retrieve child object added by object_property_add_child() List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , To: alexander_barabash@mentor.com Cc: qemu-devel@nongnu.org On 02/21/2012 11:14 AM, alexander_barabash@mentor.com wrote: > From: Alexander Barabash > > object_property_add_child() creates a property whose values as a string is > the child object's canonical path. > > Signed-off-by: Alexander Barabash > --- > include/qemu/object.h | 4 ++++ > 1 files changed, 4 insertions(+), 0 deletions(-) > > diff --git a/include/qemu/object.h b/include/qemu/object.h > index ba2409d..d9e9221 100644 > --- a/include/qemu/object.h > +++ b/include/qemu/object.h > @@ -808,6 +808,10 @@ Object *object_resolve_path_type(const char *path, const char *typename, > * > * There is no way for a child to determine what its parent is. It is not > * a bidirectional relationship. This is by design. > + * > + * The value of a child property as a C string will be the child object's > + * canonical path. It can be retrieved using object_property_get_str(). > + * The child object itself can be retrieved using object_property_get_link(). > */ > void object_property_add_child(Object *obj, const char *name, > Object *child, struct Error **errp); Acked-by: Paolo Bonzini