1 2 /*--------------------------------------------------------------------*/ 3 /*--- High-level memory management. pub_core_mallocfree.h ---*/ 4 /*--------------------------------------------------------------------*/ 5 6 /* 7 This file is part of Valgrind, a dynamic binary instrumentation 8 framework. 9 10 Copyright (C) 2000-2015 Julian Seward 11 jseward@acm.org 12 13 This program is free software; you can redistribute it and/or 14 modify it under the terms of the GNU General Public License as 15 published by the Free Software Foundation; either version 2 of the 16 License, or (at your option) any later version. 17 18 This program is distributed in the hope that it will be useful, but 19 WITHOUT ANY WARRANTY; without even the implied warranty of 20 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU 21 General Public License for more details. 22 23 You should have received a copy of the GNU General Public License 24 along with this program; if not, write to the Free Software 25 Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 26 02111-1307, USA. 27 28 The GNU General Public License is contained in the file COPYING. 29 */ 30 31 #ifndef __PUB_CORE_MALLOCFREE_H 32 #define __PUB_CORE_MALLOCFREE_H 33 34 #include "pub_tool_mallocfree.h" 35 36 //-------------------------------------------------------------------- 37 // PURPOSE: high-level memory allocation (malloc/free), for the core and 38 // tools. 39 //-------------------------------------------------------------------- 40 41 /* Allocation arenas. 42 43 CORE for the core's and tools' general use. 44 DINFO for debug info (symbols, line #s, CFI, etc) storage. 45 CLIENT for the client's mallocs/frees, if the tool replaces glibc's 46 malloc() et al -- redzone size is chosen by the tool. 47 DEMANGLE for the C++ demangler. 48 TTAUX for storing TT/TC auxiliary structures (address range 49 equivalence classes). 50 51 When adding a new arena, remember also to add it to ensure_mm_init(). 52 */ 53 typedef Int ArenaId; 54 55 #define VG_N_ARENAS 5 56 57 #define VG_AR_CORE 0 58 #define VG_AR_DINFO 1 59 #define VG_AR_CLIENT 2 60 #define VG_AR_DEMANGLE 3 61 #define VG_AR_TTAUX 4 62 63 // This is both the minimum payload size of a malloc'd block, and its 64 // minimum alignment. Must be a power of 2 greater than 4, and should be 65 // greater than 8. 66 #if defined(VGP_x86_linux) || \ 67 defined(VGP_arm_linux) || \ 68 defined(VGP_mips32_linux) || \ 69 defined(VGP_x86_solaris) 70 # define VG_MIN_MALLOC_SZB 8 71 // Nb: We always use 16 bytes for Darwin, even on 32-bits, so it can be used 72 // for any AltiVec- or SSE-related type. This matches the Darwin libc. 73 // Also, use 16 bytes for any PPC variant, since 16 is required to make 74 // Altiveccery work right. 75 #elif defined(VGP_amd64_linux) || \ 76 defined(VGP_ppc32_linux) || \ 77 defined(VGP_ppc64be_linux) || \ 78 defined(VGP_ppc64le_linux) || \ 79 defined(VGP_s390x_linux) || \ 80 defined(VGP_mips64_linux) || \ 81 defined(VGP_x86_darwin) || \ 82 defined(VGP_amd64_darwin) || \ 83 defined(VGP_arm64_linux) || \ 84 defined(VGP_tilegx_linux) || \ 85 defined(VGP_amd64_solaris) 86 # define VG_MIN_MALLOC_SZB 16 87 #else 88 # error Unknown platform 89 #endif 90 91 /* This struct definition MUST match the system one. */ 92 /* SVID2/XPG mallinfo structure */ 93 struct vg_mallinfo { 94 int arena; /* total space allocated from system */ 95 int ordblks; /* number of non-inuse chunks */ 96 int smblks; /* unused -- always zero */ 97 int hblks; /* number of mmapped regions */ 98 int hblkhd; /* total space in mmapped regions */ 99 int usmblks; /* unused -- always zero */ 100 int fsmblks; /* unused -- always zero */ 101 int uordblks; /* total allocated space */ 102 int fordblks; /* total non-inuse space */ 103 int keepcost; /* top-most, releasable (via malloc_trim) space */ 104 }; 105 106 extern void* VG_(arena_malloc) ( ArenaId arena, const HChar* cc, SizeT nbytes ); 107 extern void VG_(arena_free) ( ArenaId arena, void* ptr ); 108 extern void* VG_(arena_calloc) ( ArenaId arena, const HChar* cc, 109 SizeT nmemb, SizeT bytes_per_memb ); 110 extern void* VG_(arena_realloc) ( ArenaId arena, const HChar* cc, 111 void* ptr, SizeT size ); 112 extern void* VG_(arena_memalign)( ArenaId aid, const HChar* cc, 113 SizeT req_alignB, SizeT req_pszB ); 114 extern HChar* VG_(arena_strdup) ( ArenaId aid, const HChar* cc, 115 const HChar* s); 116 117 /* Specialised version of realloc, that shrinks the size of the block ptr from 118 its current size to req_pszB. 119 req_pszB must be <= to the current size of ptr (otherwise it will assert). 120 Compared to VG_(arena_realloc): 121 * VG_(arena_realloc_shrink) cannot increase the size of ptr. 122 * If large enough, the unused memory is made usable for other allocation. 123 * ptr is shrunk in place, so as to avoid temporary allocation and memcpy. */ 124 extern void VG_(arena_realloc_shrink) ( ArenaId aid, 125 void* ptr, SizeT req_pszB); 126 127 extern SizeT VG_(arena_malloc_usable_size) ( ArenaId aid, void* payload ); 128 129 extern SizeT VG_(arena_redzone_size) ( ArenaId aid ); 130 131 extern void VG_(mallinfo) ( ThreadId tid, struct vg_mallinfo* mi ); 132 133 // VG_(arena_perm_malloc) is for permanent allocation of small blocks. 134 // See VG_(perm_malloc) in pub_tool_mallocfree.h for more details. 135 // Do not call any VG_(arena_*) functions with these permanent blocks. 136 extern void* VG_(arena_perm_malloc) ( ArenaId aid, SizeT nbytes, Int align ); 137 138 extern void VG_(sanity_check_malloc_all) ( void ); 139 140 extern void VG_(print_all_arena_stats) ( void ); 141 142 extern void VG_(print_arena_cc_analysis) ( void ); 143 144 typedef 145 struct _AddrArenaInfo 146 AddrArenaInfo; 147 148 struct _AddrArenaInfo { 149 ArenaId aid; 150 const HChar* name; // arena name, !NULL if Addr a points in an arena. 151 SizeT block_szB; 152 PtrdiffT rwoffset; 153 Bool free; // True if this is in the arena free zone. 154 }; 155 /* If Addr a points in one of the allocation arenas, describes Addr a in *aai 156 otherwise sets *aai to 0/NULL/... 157 Note that no information is produced for addresses allocated with 158 VG_(arena_perm_malloc). */ 159 extern void VG_(describe_arena_addr) ( Addr a, /*OUT*/AddrArenaInfo* aai ); 160 161 #endif // __PUB_CORE_MALLOCFREE_H 162 163 /*--------------------------------------------------------------------*/ 164 /*--- end ---*/ 165 /*--------------------------------------------------------------------*/ 166