qom/object: update doc about NULL values in link properties
Reviewed-by: Peter Maydell <peter.maydell@linaro.org> Signed-off-by: Marc-André Lureau <marcandre.lureau@redhat.com>
Marc-André Lureau committed
May 3, 2026 at 12:00 UTC
4207565ea12b8d02c3934f92b6a2d5aabe821ee1
1 file changed
+4
-4
include/qom/object.h
+4
-4
@@ -1714,10 +1714,10 @@ void object_property_allow_set_link(const Object *obj, const char *name,
1714
*
1715
* Links form the graph in the object model.
1716
*
1717
- * The @check() callback is invoked when
1718
- * object_property_set_link() is called and can raise an error to prevent the
1719
- * link being set. If @check is NULL, the property is read-only
1720
- * and cannot be set.
1717
+ * The @check() callback is invoked when object_property_set_link() is called
1718
+ * and can raise an error to prevent the link being set. If @check is NULL, the
1719
+ * property is read-only and cannot be set. Care must be taken to handle NULL
1720
+ * values for @val.
1721
*
1722
* Ownership of the pointer that @child points to is transferred to the
1723
* link property. The reference count for *@child is