X-Git-Url: https://git.ozlabs.org/?a=blobdiff_plain;f=ccan%2Ftalloc%2Ftalloc.h;h=e4f15aeecbb1b9dde7909525da89e88c727936e9;hb=cbe5094e85d08d19393c1b66abd59aecce7c8408;hp=791c98a2bbd88c6e0e0d5571f6af341f07e007a3;hpb=f933b8c3246e3fbfe362cb1db73a4ef774725709;p=ccan diff --git a/ccan/talloc/talloc.h b/ccan/talloc/talloc.h index 791c98a2..e4f15aee 100644 --- a/ccan/talloc/talloc.h +++ b/ccan/talloc/talloc.h @@ -87,6 +87,30 @@ */ #define talloc(ctx, type) (type *)talloc_named_const(ctx, sizeof(type), #type) +/** + * talloc_set - allocate dynamic memory for a type, into a pointer + * @ptr: pointer to the pointer to assign. + * @ctx: context to be parent of this allocation, or NULL. + * + * talloc_set() does a talloc, but also adds a destructor which will make the + * pointer invalid when it is freed. This can find many use-after-free bugs. + * + * Note that the destructor is chained off a zero-length allocation, and so + * is not affected by talloc_set_destructor(). + * + * Example: + * unsigned int *a; + * a = talloc(NULL, unsigned int); + * talloc_set(&b, a, unsigned int); + * talloc_free(a); + * *b = 1; // This will crash! + * + * See Also: + * talloc. + */ +#define talloc_set(pptr, ctx) \ + _talloc_set((pptr), (ctx), sizeof(&**(pptr)), __location__) + /** * talloc_free - free talloc'ed memory and its children * @ptr: the talloced pointer to free @@ -119,7 +143,7 @@ * See Also: * talloc_set_destructor, talloc_unlink */ -int talloc_free(void *ptr); +int talloc_free(const void *ptr); /** * talloc_set_destructor: set a destructor for when this pointer is freed @@ -172,7 +196,7 @@ int talloc_free(void *ptr); * talloc, talloc_free */ #define talloc_set_destructor(ptr, function) \ - _talloc_set_destructor((ptr), typesafe_cb(int, (function), (ptr))) + _talloc_set_destructor((ptr), typesafe_cb_def(int, (function), (ptr))) /** * talloc_zero - allocate zeroed dynamic memory for a type @@ -940,6 +964,7 @@ void *talloc_add_external(const void *ctx, /* The following definitions come from talloc.c */ void *_talloc(const void *context, size_t size); +void _talloc_set(void *ptr, const void *ctx, size_t size, const char *name); void _talloc_set_destructor(const void *ptr, int (*destructor)(void *)); size_t talloc_reference_count(const void *ptr); void *_talloc_reference(const void *context, const void *ptr);