summaryrefslogtreecommitdiff
path: root/lib
diff options
context:
space:
mode:
authorAndreas Schneider <asn@samba.org>2013-10-14 13:17:12 +0200
committerAndreas Schneider <asn@cryptomilk.org>2013-10-14 23:05:54 +0200
commit2343df451a13115eebfd46f9247ec2ae8c3a85c0 (patch)
tree05cd9b72e1bdfc758a5f9b573028d064eb7b9af2 /lib
parent477e53a8cb5eda594cfe1cccb9890a4fcd586ff1 (diff)
downloadsamba-2343df451a13115eebfd46f9247ec2ae8c3a85c0.tar.gz
samba-2343df451a13115eebfd46f9247ec2ae8c3a85c0.tar.bz2
samba-2343df451a13115eebfd46f9247ec2ae8c3a85c0.zip
talloc: Add a warning to talloc_reference() documentation.
Signed-off-by: Andreas Schneider <asn@samba.org> Reviewed-by: Kai Blin <kai@samba.org> Autobuild-User(master): Andreas Schneider <asn@cryptomilk.org> Autobuild-Date(master): Mon Oct 14 23:05:54 CEST 2013 on sn-devel-104
Diffstat (limited to 'lib')
-rw-r--r--lib/talloc/talloc.h8
1 files changed, 8 insertions, 0 deletions
diff --git a/lib/talloc/talloc.h b/lib/talloc/talloc.h
index 1b59390e33..5d29a8d5cf 100644
--- a/lib/talloc/talloc.h
+++ b/lib/talloc/talloc.h
@@ -961,6 +961,10 @@ size_t talloc_reference_count(const void *ptr);
* @return The original pointer 'ptr', NULL if talloc ran out of
* memory in creating the reference.
*
+ * @warning You should try to avoid using this interface. It turns a beautiful
+ * talloc-tree into a graph. It is often really hard to debug if you
+ * screw something up by accident.
+ *
* Example:
* @code
* unsigned int *a, *b, *c;
@@ -1001,6 +1005,10 @@ void *_talloc_reference_loc(const void *context, const void *ptr, const char *lo
* this function will fail and will return -1. Likewise, if ptr is NULL,
* then the function will make no modifications and return -1.
*
+ * @warning You should try to avoid using this interface. It turns a beautiful
+ * talloc-tree into a graph. It is often really hard to debug if you
+ * screw something up by accident.
+ *
* Example:
* @code
* unsigned int *a, *b, *c;