Subversion Repositories Kolibri OS

Rev

Rev 3584 | Blame | Last modification | View Log | RSS feed

  1. #ifndef _TALLOC_H_
  2. #define _TALLOC_H_
  3. /*
  4.    Unix SMB/CIFS implementation.
  5.    Samba temporary memory allocation functions
  6.  
  7.    Copyright (C) Andrew Tridgell 2004-2005
  8.    Copyright (C) Stefan Metzmacher 2006
  9.    
  10.      ** NOTE! The following LGPL license applies to the talloc
  11.      ** library. This does NOT imply that all of Samba is released
  12.      ** under the LGPL
  13.    
  14.    This library is free software; you can redistribute it and/or
  15.    modify it under the terms of the GNU Lesser General Public
  16.    License as published by the Free Software Foundation; either
  17.    version 2 of the License, or (at your option) any later version.
  18.  
  19.    This library is distributed in the hope that it will be useful,
  20.    but WITHOUT ANY WARRANTY; without even the implied warranty of
  21.    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  22.    Lesser General Public License for more details.
  23.  
  24.    You should have received a copy of the GNU Lesser General Public
  25.    License along with this library; if not, write to the Free Software
  26.    Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  27. */
  28.  
  29. #include <stdlib.h>
  30. #include <stdio.h>
  31. #include <stdarg.h>
  32.  
  33. /* this is only needed for compatibility with the old talloc */
  34. typedef void TALLOC_CTX;
  35.  
  36. /*
  37.   this uses a little trick to allow __LINE__ to be stringified
  38. */
  39. #ifndef __location__
  40. #define __TALLOC_STRING_LINE1__(s)    #s
  41. #define __TALLOC_STRING_LINE2__(s)   __TALLOC_STRING_LINE1__(s)
  42. #define __TALLOC_STRING_LINE3__  __TALLOC_STRING_LINE2__(__LINE__)
  43. #define __location__ __FILE__ ":" __TALLOC_STRING_LINE3__
  44. #endif
  45.  
  46. #ifndef TALLOC_DEPRECATED
  47. #define TALLOC_DEPRECATED 0
  48. #endif
  49.  
  50. #ifndef PRINTF_ATTRIBUTE
  51. #if (__GNUC__ >= 3)
  52. /** Use gcc attribute to check printf fns.  a1 is the 1-based index of
  53.  * the parameter containing the format, and a2 the index of the first
  54.  * argument. Note that some gcc 2.x versions don't handle this
  55.  * properly **/
  56. #define PRINTF_ATTRIBUTE(a1, a2) __attribute__ ((format (__printf__, a1, a2)))
  57. #else
  58. #define PRINTF_ATTRIBUTE(a1, a2)
  59. #endif
  60. #endif
  61.  
  62. /* try to make talloc_set_destructor() and talloc_steal() type safe,
  63.    if we have a recent gcc */
  64. #if (__GNUC__ >= 3)
  65. #define _TALLOC_TYPEOF(ptr) __typeof__(ptr)
  66. #define talloc_set_destructor(ptr, function)                                  \
  67.         do {                                                                  \
  68.                 int (*_talloc_destructor_fn)(_TALLOC_TYPEOF(ptr)) = (function);       \
  69.                 _talloc_set_destructor((ptr), (int (*)(void *))_talloc_destructor_fn); \
  70.         } while(0)
  71. /* this extremely strange macro is to avoid some braindamaged warning
  72.    stupidity in gcc 4.1.x */
  73. #define talloc_steal(ctx, ptr) ({ _TALLOC_TYPEOF(ptr) __talloc_steal_ret = (_TALLOC_TYPEOF(ptr))_talloc_steal((ctx),(ptr)); __talloc_steal_ret; })
  74. #else
  75. #define talloc_set_destructor(ptr, function) \
  76.         _talloc_set_destructor((ptr), (int (*)(void *))(function))
  77. #define _TALLOC_TYPEOF(ptr) void *
  78. #define talloc_steal(ctx, ptr) (_TALLOC_TYPEOF(ptr))_talloc_steal((ctx),(ptr))
  79. #endif
  80.  
  81. #define talloc_reference(ctx, ptr) (_TALLOC_TYPEOF(ptr))_talloc_reference((ctx),(ptr))
  82. #define talloc_move(ctx, ptr) (_TALLOC_TYPEOF(*(ptr)))_talloc_move((ctx),(void *)(ptr))
  83.  
  84. /* useful macros for creating type checked pointers */
  85. #define talloc(ctx, type) (type *)talloc_named_const(ctx, sizeof(type), #type)
  86. #define talloc_size(ctx, size) talloc_named_const(ctx, size, __location__)
  87. #define talloc_ptrtype(ctx, ptr) (_TALLOC_TYPEOF(ptr))talloc_size(ctx, sizeof(*(ptr)))
  88.  
  89. #define talloc_new(ctx) talloc_named_const(ctx, 0, "talloc_new: " __location__)
  90.  
  91. #define talloc_zero(ctx, type) (type *)_talloc_zero(ctx, sizeof(type), #type)
  92. #define talloc_zero_size(ctx, size) _talloc_zero(ctx, size, __location__)
  93.  
  94. #define talloc_zero_array(ctx, type, count) (type *)_talloc_zero_array(ctx, sizeof(type), count, #type)
  95. #define talloc_array(ctx, type, count) (type *)_talloc_array(ctx, sizeof(type), count, #type)
  96. #define talloc_array_size(ctx, size, count) _talloc_array(ctx, size, count, __location__)
  97. #define talloc_array_ptrtype(ctx, ptr, count) (_TALLOC_TYPEOF(ptr))talloc_array_size(ctx, sizeof(*(ptr)), count)
  98.  
  99. #define talloc_realloc(ctx, p, type, count) (type *)_talloc_realloc_array(ctx, p, sizeof(type), count, #type)
  100. #define talloc_realloc_size(ctx, ptr, size) _talloc_realloc(ctx, ptr, size, __location__)
  101.  
  102. #define talloc_memdup(t, p, size) _talloc_memdup(t, p, size, __location__)
  103.  
  104. #define talloc_set_type(ptr, type) talloc_set_name_const(ptr, #type)
  105. #define talloc_get_type(ptr, type) (type *)talloc_check_name(ptr, #type)
  106.  
  107. #define talloc_find_parent_bytype(ptr, type) (type *)talloc_find_parent_byname(ptr, #type)
  108.  
  109. #if TALLOC_DEPRECATED
  110. #define talloc_zero_p(ctx, type) talloc_zero(ctx, type)
  111. #define talloc_p(ctx, type) talloc(ctx, type)
  112. #define talloc_array_p(ctx, type, count) talloc_array(ctx, type, count)
  113. #define talloc_realloc_p(ctx, p, type, count) talloc_realloc(ctx, p, type, count)
  114. #define talloc_destroy(ctx) talloc_free(ctx)
  115. #endif
  116.  
  117. /* The following definitions come from talloc.c  */
  118. void *_talloc(const void *context, size_t size);
  119. void _talloc_set_destructor(const void *ptr, int (*destructor)(void *));
  120. int talloc_increase_ref_count(const void *ptr);
  121. size_t talloc_reference_count(const void *ptr);
  122. void *_talloc_reference(const void *context, const void *ptr);
  123. int talloc_unlink(const void *context, void *ptr);
  124. const char *talloc_set_name(const void *ptr, const char *fmt, ...) PRINTF_ATTRIBUTE(2,3);
  125. void talloc_set_name_const(const void *ptr, const char *name);
  126. void *talloc_named(const void *context, size_t size,
  127.                    const char *fmt, ...) PRINTF_ATTRIBUTE(3,4);
  128. void *talloc_named_const(const void *context, size_t size, const char *name);
  129. const char *talloc_get_name(const void *ptr);
  130. void *talloc_check_name(const void *ptr, const char *name);
  131. void *talloc_parent(const void *ptr);
  132. const char *talloc_parent_name(const void *ptr);
  133. void *talloc_init(const char *fmt, ...) PRINTF_ATTRIBUTE(1,2);
  134. int talloc_free(void *ptr);
  135. void talloc_free_children(void *ptr);
  136. void *_talloc_realloc(const void *context, void *ptr, size_t size, const char *name);
  137. void *_talloc_steal(const void *new_ctx, const void *ptr);
  138. void *_talloc_move(const void *new_ctx, const void *pptr);
  139. size_t talloc_total_size(const void *ptr);
  140. size_t talloc_total_blocks(const void *ptr);
  141. void talloc_report_depth_cb(const void *ptr, int depth, int max_depth,
  142.                             void (*callback)(const void *ptr,
  143.                                              int depth, int max_depth,
  144.                                              int is_ref,
  145.                                              void *private_data),
  146.                             void *private_data);
  147. void talloc_report_depth_file(const void *ptr, int depth, int max_depth, FILE *f);
  148. void talloc_report_full(const void *ptr, FILE *f);
  149. void talloc_report(const void *ptr, FILE *f);
  150. void talloc_enable_null_tracking(void);
  151. void talloc_disable_null_tracking(void);
  152. void talloc_enable_leak_report(void);
  153. void talloc_enable_leak_report_full(void);
  154. void *_talloc_zero(const void *ctx, size_t size, const char *name);
  155. void *_talloc_memdup(const void *t, const void *p, size_t size, const char *name);
  156. char *talloc_strdup(const void *t, const char *p);
  157. char *talloc_strndup(const void *t, const char *p, size_t n);
  158. char *talloc_append_string(const void *t, char *orig, const char *append);
  159. char *talloc_vasprintf(const void *t, const char *fmt, va_list ap) PRINTF_ATTRIBUTE(2,0);
  160. char *talloc_vasprintf_append(char *s, const char *fmt, va_list ap) PRINTF_ATTRIBUTE(2,0);
  161. char *talloc_asprintf(const void *t, const char *fmt, ...) PRINTF_ATTRIBUTE(2,3);
  162. char *talloc_asprintf_append(char *s, const char *fmt, ...) PRINTF_ATTRIBUTE(2,3);
  163. void *_talloc_array(const void *ctx, size_t el_size, unsigned count, const char *name);
  164. void *_talloc_zero_array(const void *ctx, size_t el_size, unsigned count, const char *name);
  165. void *_talloc_realloc_array(const void *ctx, void *ptr, size_t el_size, unsigned count, const char *name);
  166. void *talloc_realloc_fn(const void *context, void *ptr, size_t size);
  167. void *talloc_autofree_context(void);
  168. size_t talloc_get_size(const void *ctx);
  169. void *talloc_find_parent_byname(const void *ctx, const char *name);
  170. void talloc_show_parents(const void *context, FILE *file);
  171. int talloc_is_parent(const void *context, const void *ptr);
  172.  
  173. #endif
  174.