summaryrefslogtreecommitdiff
path: root/talloc_guide.txt
AgeCommit message (Collapse)AuthorFilesLines
2007-10-10r3366: updates from the junkcode version of talloc.Andrew Tridgell1-16/+35
The main change is to get rid of talloc_parent_chunk() from all commonly used code paths, so talloc_free() is now O(1) again. It was originally O(1), but the last round of changes broke that. Also some documentation updates (This used to be commit d4fe21cdb982c8046b19f671d872b43cdd2efc72)
2007-10-10r2792: got rid of talloc_ldb_alloc() and instead created talloc_realloc_fn(),Andrew Tridgell1-0/+10
so talloc now doesn't contain any ldb specific functions. allow NULL to be passed to a couple more talloc() functions (This used to be commit 1246f80d806fb5f63cfbf3879de6d546384552a8)
2007-10-10r2791: got rid of talloc_unreference() and instead created talloc_unlink(),Andrew Tridgell1-17/+19
which is much clearer and simpler to use. It removes a specific parent from a pointer, no matter whether that parent is a "reference" or a direct parent. This gives complete control over the free process. (This used to be commit 6c563887f1b9b8c842309a523e88b6f2a32db10f)
2007-10-10r2745: added some example talloc reportsAndrew Tridgell1-0/+22
(This used to be commit 10e2a4fd2b85d69b55efa8c36eb553dceda844ad)
2007-10-10r2744: ben elliston taught me about gcov today, which allows you to measureAndrew Tridgell1-1/+3
the % coverage in terms of lines of code of a test suite. I thought a good first place to start with gcov was the talloc test suite. When I started the test suite covered about 60% of all lines of code in talloc.c, and now it covers about 99%. The only lines not covered are talloc corruption errors, as that would cause smb_panic() to fire. It will be interesting to try gcov on the main Samba test suite for smbd. We won't achieve 100% coverage, but it would be nice to get to 90% or more. I also modified the talloc.c sources to be able to be build standalone, using: gcc -c -D_STANDALONE_ -Iinlcude lib/talloc.c that should make it much easier to re-use talloc in other projects (This used to be commit 8d4dc99b82efdf24b6811851c7bdd4af5a4c52c9)
2007-10-10r2743: fixed some errors in the description of talloc_reference(). VolkerAndrew Tridgell1-6/+38
told me he found the description confusing, and given that some of it was not correct I am not surprised! added some more docs on the reporting calls (This used to be commit 43079cfc80317b6d0d2679f9377aac259e0f8fc7)
2007-10-10r2733: added a note on performanceAndrew Tridgell1-0/+12
(This used to be commit 171fe8209794bb1e61283126ccc165b43fbcfa62)
2007-10-10r2719: an additional note on talloc_unreference()Andrew Tridgell1-0/+5
(This used to be commit 078d13181313f98c1df50185ebae4629cca98ee0)
2007-10-10r2718: - added a talloc_unreference() function as requested by metze.Andrew Tridgell1-0/+11
- added documentation for talloc_unreference() - made the abandoned child logic in talloc_free() clearer and more consistent (This used to be commit a87584c8e3fb06cd3ff29a918f681b5c6c32b9ff)
2007-10-10r2717: added talloc_p() docsAndrew Tridgell1-0/+13
(This used to be commit 6743ca1b1a24776559aa1c04f0f4a33c67cea8a7)
2007-10-10r2716: created a separate detailed talloc_guide.txt document, after volkerAndrew Tridgell1-0/+361
complained it was all too confusing :-) I recommend that everyone who wants to work on Samba4 have a read of this. (This used to be commit c4c427576c02b27d829ae4aaee31cbf893b4a2ad)