summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--talloc_guide.txt5
1 files changed, 5 insertions, 0 deletions
diff --git a/talloc_guide.txt b/talloc_guide.txt
index 6920ea16f1..ae75f73d8e 100644
--- a/talloc_guide.txt
+++ b/talloc_guide.txt
@@ -134,6 +134,11 @@ as talloc_reference().
Note that if the reference has already been removed using
talloc_free() then this function will fail and will return NULL.
+Usually you can just use talloc_free() instead of
+talloc_unreference(), but sometimes it is useful to have the
+additional control on who becomes the parent of the pointer given by
+talloc_unreference().
+
=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
void talloc_set_destructor(const void *ptr, int (*destructor)(void *));