sin/samba-mirror
1
0
Fork 0
mirror of https://github.com/samba-team/samba.git synced 2025-01-26 10:04:02 +03:00
Code

Doc

Browse Source 
(This used to be commit 7da982e9268be7eb93fe7d6ad7da5b33ce44181c)
This commit is contained in:
Martin Pool 2001-12-19 06:22:23 +00:00
parent 0b73aad2bf
commit fc00418dfc
2 changed files with 21 additions and 9 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

10
source3/include/talloc.h
View File

@ -22,6 +22,12 @@
Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
*/
/**
* @ingroup talloc
* @{
* @sa talloc.c
*/
struct talloc_chunk {
struct talloc_chunk *next;
size_t size;
@ -50,4 +56,6 @@ char *talloc_vasprintf(TALLOC_CTX *t, const char *fmt, va_list ap)
char *talloc_asprintf(TALLOC_CTX *t, const char *fmt, ...)
PRINTF_ATTRIBUTE(2, 3);
#endif
/** @} */
#endif /* ndef _TALLOC_H_ */

20
source3/lib/talloc.c
View File

@ -36,9 +36,12 @@
talloc does not zero the memory. It guarantees memory of a
TALLOC_ALIGN alignment
@sa talloc.h
*/
/* TODO: We could allocate both the talloc_chunk structure, and the
/**
* @todo We could allocate both the talloc_chunk structure, and the
* memory it contains all in one allocation, which might be a bit
* faster and perhaps use less memory overhead.
*
@ -106,7 +109,7 @@ void *talloc(TALLOC_CTX *t, size_t size)
return p;
}
/* a talloc version of realloc */
/** A talloc version of realloc */
void *talloc_realloc(TALLOC_CTX *t, void *ptr, size_t size)
{
struct talloc_chunk *tc;
@ -133,7 +136,8 @@ void *talloc_realloc(TALLOC_CTX *t, void *ptr, size_t size)
return NULL;
}
/* destroy a whole pool */
/** Destroy all the memory allocated inside @p t, but not @p t
* itself. */
void talloc_destroy_pool(TALLOC_CTX *t)
{
struct talloc_chunk *c;
@ -151,7 +155,7 @@ void talloc_destroy_pool(TALLOC_CTX *t)
t->total_alloc_size = 0;
}
/* destroy a whole pool including the context */
/** Destroy a whole pool including the context */
void talloc_destroy(TALLOC_CTX *t)
{
if (!t)
@ -161,13 +165,13 @@ void talloc_destroy(TALLOC_CTX *t)
SAFE_FREE(t);
}
/* return the current total size of the pool. */
/** Return the current total size of the pool. */
size_t talloc_pool_size(TALLOC_CTX *t)
{
return t->total_alloc_size;
}
/* talloc and zero memory. */
/** talloc and zero memory. */
void *talloc_zero(TALLOC_CTX *t, size_t size)
{
void *p = talloc(t, size);
@ -178,7 +182,7 @@ void *talloc_zero(TALLOC_CTX *t, size_t size)
return p;
}
/* memdup with a talloc. */
/** memdup with a talloc. */
void *talloc_memdup(TALLOC_CTX *t, const void *p, size_t size)
{
void *newp = talloc(t,size);
@ -191,7 +195,7 @@ void *talloc_memdup(TALLOC_CTX *t, const void *p, size_t size)
return newp;
}
/* strdup with a talloc */
/** strdup with a talloc */
char *talloc_strdup(TALLOC_CTX *t, const char *p)
{
return talloc_memdup(t, p, strlen(p) + 1);