Lines Matching refs:a
11 as talloc has changed a lot.
13 The new talloc is a hierarchical, reference counted memory pool system
14 with destructors. Quite a mounthful really, but not too bad once you
18 between a "talloc context" and a "talloc pointer". Any pointer
19 returned from talloc() is itself a valid talloc context. This means
25 and the pointer X->name would be a "child" of the talloc context "X"
26 which is itself a child of mem_ctx. So if you do talloc_free(mem_ctx)
43 All the additional features of talloc() over malloc() do come at a
44 price. We have a simple performance test in Samba4 that measures
55 The following is a complete guide to the talloc API. Read it all at
62 The talloc() macro is the core of the talloc library. It takes a
63 memory context and a type, and returns a pointer to a new area of
66 The returned pointer is itself a talloc context, so you can use it as
69 The returned pointer is a "child" of the supplied context. This means
73 The context argument to talloc() can be NULL, in which case a new top
80 The function talloc_size() should be used when you don't have a
82 safe (as it returns a void *), so you are on your own for type checking.
88 The talloc_free() function frees a piece of talloc memory, and all its
94 condition is if the pointer had a destructor attached to it and the
111 The talloc_free_children() walks along the list of all children of a
127 If "ptr" is NULL, then the function is a no-op, and simply returns NULL.
129 After creating a reference you can free it in one of the following
138 pointer as a child of its current parent.
146 The talloc_unlink() function removes a specific parent from ptr. The
147 context passed must either be a context used in talloc_reference()
148 with this pointer, or must be a direct parent of ptr.
163 pointer "ptr". A destructor is a function that is called when the
164 memory used by a pointer is about to be released. The destructor
173 You can only place one destructor on a pointer. If you need more than
174 one destructor then you can create a zero-length child of the pointer
177 To remove a destructor call talloc_set_destructor() with NULL for the
182 be ignored. This would be a pointless operation anyway, as the
200 Each talloc pointer has a "name". The name is used principally for
202 name on a pointer in as a way of "marking" pointers in your code.
208 The talloc_set_name() function allocates memory as a child of the
221 but it takes a string constant, and is much faster. It is extensively
226 ptr. This means you must not pass a name pointer to memory that will
233 The talloc_named() function creates a named talloc pointer. It is
259 This function creates a zero length named talloc context as a top
268 This is a utility macro that creates a new memory context hanging
271 particularly useful for creating a new temporary working context.
277 The talloc_realloc() macro changes the size of a talloc
291 will fail either due to a lack of memory, or because the pointer has
305 The talloc_steal() function changes the parent context of a talloc
307 currently a child of is going to be freed and you wish to keep the
308 memory for a longer time.
325 Passing NULL is allowed, but it will only give a meaningful result if
337 Passing NULL is allowed, but it will only give a meaningful result if
345 The talloc_report() function prints a summary report of all memory
349 You can pass NULL for the pointer, in which case a report is printed
358 This provides a more detailed report than talloc_report(). It will
363 You can pass NULL for the pointer, in which case a report is printed
377 talloc function as it establishes a "null context" that acts as the
382 Here is a typical talloc report:
402 talloc function as it establishes a "null context" that acts as the
407 Here is a typical full report:
439 The talloc_zero_size() function is useful when you don't have a known type
514 known. It operates in the same way as talloc_array(), but takes a size
515 instead of a type.
521 This is a non-macro version of talloc_realloc(), which is useful
522 as libraries sometimes want a ralloc function pointer. A realloc()
525 around a single function pointer.
531 This is a handy utility function that returns a talloc context
539 This function checks if a pointer has the specified name. If it does
556 This macro allows you to force the name of a pointer to be a