From 6c232d2ffb7cf60e9fdf5dc17c5d5f7fe6d1ca64 Mon Sep 17 00:00:00 2001 From: Paolo Bonzini Date: Fri, 25 Jan 2013 14:12:31 +0100 Subject: [PATCH] qom: document reference counting of link properties Signed-off-by: Paolo Bonzini Signed-off-by: Anthony Liguori --- include/qom/object.h | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/include/qom/object.h b/include/qom/object.h index 48e80ba229..bfd848ffe3 100644 --- a/include/qom/object.h +++ b/include/qom/object.h @@ -1041,6 +1041,11 @@ void object_property_add_child(Object *obj, const char *name, * between objects. * * Links form the graph in the object model. + * + * Ownership of the pointer that @child points to is transferred to the + * link property. The reference count for *@child is + * managed by the property from after the function returns till the + * property is deleted with object_property_del(). */ void object_property_add_link(Object *obj, const char *name, const char *type, Object **child,