talloc.h

   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 3 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, see <http://www.gnu.org/licenses/>.
  26 */
  27
  28 #include <stdlib.h>
  29 #include <stdio.h>
  30 #include <stdarg.h>
  31
  32 #include "mpcommon.h"
  33
  34 /* HACK: libsmbclient uses dynamically linked libtalloc.so which has
  35  * identically named symbols. This name collision caused a crash under
  36  * stream_smb when trying to play anything with smb://. This hack
  37  * prevents the symbols declared here from being visible to outside
  38  * shared libraries and fixes the crash.
  39  */
  40 #pragma GCC visibility push(hidden)
  41
  42 /* this is only needed for compatibility with the old talloc */
  43 typedef void TALLOC_CTX;
  44
  45 /*
  46   this uses a little trick to allow __LINE__ to be stringified
  47 */
  48 #ifndef __location__
  49 #define __TALLOC_STRING_LINE1__(s)    #s
  50 #define __TALLOC_STRING_LINE2__(s)   __TALLOC_STRING_LINE1__(s)
  51 #define __TALLOC_STRING_LINE3__  __TALLOC_STRING_LINE2__(__LINE__)
  52 #define __location__ __FILE__ ":" __TALLOC_STRING_LINE3__
  53 #endif
  54
  55 #ifndef TALLOC_DEPRECATED
  56 #define TALLOC_DEPRECATED 0
  57 #endif
  58
  59 /* try to make talloc_set_destructor() and talloc_steal() type safe,
  60    if we have a recent gcc */
  61 #if (__GNUC__ >= 3)
  62 #define _TALLOC_TYPEOF(ptr) __typeof__(ptr)
  63 /* this extremely strange macro is to avoid some braindamaged warning
  64    stupidity in gcc 4.1.x */
  65 #define talloc_steal(ctx, ptr) ({ _TALLOC_TYPEOF(ptr) __talloc_steal_ret = (_TALLOC_TYPEOF(ptr))_talloc_steal((ctx),(ptr)); __talloc_steal_ret; })
  66 #else
  67 #define _TALLOC_TYPEOF(ptr) void *
  68 #define talloc_steal(ctx, ptr) (_TALLOC_TYPEOF(ptr))_talloc_steal((ctx),(ptr))
  69 #endif
  70 #define talloc_set_destructor(ptr, function) \
  71         _talloc_set_destructor((ptr), (function))
  72
  73 #define talloc_reference(ctx, ptr) (_TALLOC_TYPEOF(ptr))_talloc_reference((ctx),(ptr))
  74 #define talloc_move(ctx, ptr) (_TALLOC_TYPEOF(*(ptr)))_talloc_move((ctx),(void *)(ptr))
  75
  76 /* useful macros for creating type checked pointers */
  77 #define talloc(ctx, type) (type *)talloc_named_const(ctx, sizeof(type), #type)
  78 #define talloc_size(ctx, size) talloc_named_const(ctx, size, __location__)
  79 #define talloc_ptrtype(ctx, ptr) (_TALLOC_TYPEOF(ptr))talloc_size(ctx, sizeof(*(ptr)))
  80
  81 #define talloc_new(ctx) talloc_named_const(ctx, 0, "talloc_new: " __location__)
  82
  83 #define talloc_zero(ctx, type) (type *)_talloc_zero(ctx, sizeof(type), #type)
  84 #define talloc_zero_size(ctx, size) _talloc_zero(ctx, size, __location__)
  85
  86 #define talloc_zero_array(ctx, type, count) (type *)_talloc_zero_array(ctx, sizeof(type), count, #type)
  87 #define talloc_array(ctx, type, count) (type *)_talloc_array(ctx, sizeof(type), count, #type)
  88 #define talloc_array_size(ctx, size, count) _talloc_array(ctx, size, count, __location__)
  89 #define talloc_array_ptrtype(ctx, ptr, count) (_TALLOC_TYPEOF(ptr))talloc_array_size(ctx, sizeof(*(ptr)), count)
  90
  91 #define talloc_realloc(ctx, p, type, count) (type *)_talloc_realloc_array(ctx, p, sizeof(type), count, #type)
  92 #define talloc_realloc_size(ctx, ptr, size) _talloc_realloc(ctx, ptr, size, __location__)
  93
  94 #define talloc_memdup(t, p, size) _talloc_memdup(t, p, size, __location__)
  95
  96 #define talloc_set_type(ptr, type) talloc_set_name_const(ptr, #type)
  97 #define talloc_get_type(ptr, type) (type *)talloc_check_name(ptr, #type)
  98
  99 #define talloc_find_parent_bytype(ptr, type) (type *)talloc_find_parent_byname(ptr, #type)
 100
 101 #if TALLOC_DEPRECATED
 102 #define talloc_zero_p(ctx, type) talloc_zero(ctx, type)
 103 #define talloc_p(ctx, type) talloc(ctx, type)
 104 #define talloc_array_p(ctx, type, count) talloc_array(ctx, type, count)
 105 #define talloc_realloc_p(ctx, p, type, count) talloc_realloc(ctx, p, type, count)
 106 #define talloc_destroy(ctx) talloc_free(ctx)
 107 #define talloc_append_string(c, s, a) (s?talloc_strdup_append(s,a):talloc_strdup(c, a))
 108 #endif
 109
 110 /* The following definitions come from talloc.c  */
 111 void *_talloc(const void *context, size_t size);
 112 void *talloc_pool(const void *context, size_t size);
 113 void _talloc_set_destructor(const void *ptr, int (*destructor)(void *));
 114 int talloc_increase_ref_count(const void *ptr);
 115 size_t talloc_reference_count(const void *ptr);
 116 void *_talloc_reference(const void *context, const void *ptr);
 117 int talloc_unlink(const void *context, void *ptr);
 118 const char *talloc_set_name(const void *ptr, const char *fmt, ...) PRINTF_ATTRIBUTE(2,3);
 119 void talloc_set_name_const(const void *ptr, const char *name);
 120 void *talloc_named(const void *context, size_t size,
 121                    const char *fmt, ...) PRINTF_ATTRIBUTE(3,4);
 122 void *talloc_named_const(const void *context, size_t size, const char *name);
 123 const char *talloc_get_name(const void *ptr);
 124 void *talloc_check_name(const void *ptr, const char *name);
 125 void *talloc_parent(const void *ptr);
 126 const char *talloc_parent_name(const void *ptr);
 127 void *talloc_init(const char *fmt, ...) PRINTF_ATTRIBUTE(1,2);
 128 int talloc_free(void *ptr);
 129 void talloc_free_children(void *ptr);
 130 void *_talloc_realloc(const void *context, void *ptr, size_t size, const char *name);
 131 void *_talloc_steal(const void *new_ctx, const void *ptr);
 132 void *_talloc_move(const void *new_ctx, const void *pptr);
 133 size_t talloc_total_size(const void *ptr);
 134 size_t talloc_total_blocks(const void *ptr);
 135 void talloc_report_depth_cb(const void *ptr, int depth, int max_depth,
 136                             void (*callback)(const void *ptr,
 137                                              int depth, int max_depth,
 138                                              int is_ref,
 139                                              void *private_data),
 140                             void *private_data);
 141 void talloc_report_depth_file(const void *ptr, int depth, int max_depth, FILE *f);
 142 void talloc_report_full(const void *ptr, FILE *f);
 143 void talloc_report(const void *ptr, FILE *f);
 144 void talloc_enable_null_tracking(void);
 145 void talloc_disable_null_tracking(void);
 146 void talloc_enable_leak_report(void);
 147 void talloc_enable_leak_report_full(void);
 148 void *_talloc_zero(const void *ctx, size_t size, const char *name);
 149 void *_talloc_memdup(const void *t, const void *p, size_t size, const char *name);
 150 void *_talloc_array(const void *ctx, size_t el_size, unsigned count, const char *name);
 151 void *_talloc_zero_array(const void *ctx, size_t el_size, unsigned count, const char *name);
 152 void *_talloc_realloc_array(const void *ctx, void *ptr, size_t el_size, unsigned count, const char *name);
 153 void *talloc_realloc_fn(const void *context, void *ptr, size_t size);
 154 void *talloc_autofree_context(void);
 155 size_t talloc_get_size(const void *ctx);
 156 void *talloc_find_parent_byname(const void *ctx, const char *name);
 157 void talloc_show_parents(const void *context, FILE *file);
 158 int talloc_is_parent(const void *context, const void *ptr);
 159
 160 char *talloc_strdup(const void *t, const char *p);
 161 char *talloc_strdup_append(char *s, const char *a);
 162 char *talloc_strdup_append_buffer(char *s, const char *a);
 163
 164 char *talloc_strndup(const void *t, const char *p, size_t n);
 165 char *talloc_strndup_append(char *s, const char *a, size_t n);
 166 char *talloc_strndup_append_buffer(char *s, const char *a, size_t n);
 167
 168 char *talloc_vasprintf(const void *t, const char *fmt, va_list ap) PRINTF_ATTRIBUTE(2,0);
 169 char *talloc_vasprintf_append(char *s, const char *fmt, va_list ap) PRINTF_ATTRIBUTE(2,0);
 170 char *talloc_vasprintf_append_buffer(char *s, const char *fmt, va_list ap) PRINTF_ATTRIBUTE(2,0);
 171
 172 char *talloc_asprintf(const void *t, const char *fmt, ...) PRINTF_ATTRIBUTE(2,3);
 173 char *talloc_asprintf_append(char *s, const char *fmt, ...) PRINTF_ATTRIBUTE(2,3);
 174 char *talloc_asprintf_append_buffer(char *s, const char *fmt, ...) PRINTF_ATTRIBUTE(2,3);
 175
 176 // end of visibility hack from above
 177 #pragma GCC visibility pop
 178 #endif