mirror of
https://github.com/samba-team/samba.git
synced 2024-12-24 21:34:56 +03:00
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
This commit is contained in:
parent
477e53a8cb
commit
2343df451a
@ -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;
|
||||
|
Loading…
Reference in New Issue
Block a user