aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorPaolo Bonzini <pbonzini@redhat.com>2013-01-25 14:12:31 +0100
committerAnthony Liguori <aliguori@us.ibm.com>2013-02-01 15:53:10 -0600
commit6c232d2ffb7cf60e9fdf5dc17c5d5f7fe6d1ca64 (patch)
tree3385e29b90dc8673ded346e33e6bccc6c0c026dc
parent52e636cdd8528b8f72f43b653356ac177524912b (diff)
qom: document reference counting of link properties
Signed-off-by: Paolo Bonzini <pbonzini@redhat.com> Signed-off-by: Anthony Liguori <aliguori@us.ibm.com>
-rw-r--r--include/qom/object.h5
1 files changed, 5 insertions, 0 deletions
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 <code>*@child</code> 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,