From 358b54654aa85f97402aca4be3b1a7b7d08bab70 Mon Sep 17 00:00:00 2001 From: Alexander Barabash Date: Tue, 21 Feb 2012 12:14:22 +0200 Subject: [PATCH] qom: Document ways to retrieve child object added by object_property_add_child() object_property_add_child() creates a property whose values as a string is the child object's canonical path. Acked-by: Paolo Bonzini Signed-off-by: Alexander Barabash Signed-off-by: Anthony Liguori --- include/qemu/object.h | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/include/qemu/object.h b/include/qemu/object.h index ff6be14..69e4b7b 100644 --- a/include/qemu/object.h +++ b/include/qemu/object.h @@ -837,6 +837,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); -- 2.7.4