1 /* Copyright (c) 2003, Google Inc. 2 * All rights reserved. 3 * 4 * Redistribution and use in source and binary forms, with or without 5 * modification, are permitted provided that the following conditions are 6 * met: 7 * 8 * * Redistributions of source code must retain the above copyright 9 * notice, this list of conditions and the following disclaimer. 10 * * Redistributions in binary form must reproduce the above 11 * copyright notice, this list of conditions and the following disclaimer 12 * in the documentation and/or other materials provided with the 13 * distribution. 14 * * Neither the name of Google Inc. nor the names of its 15 * contributors may be used to endorse or promote products derived from 16 * this software without specific prior written permission. 17 * 18 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 19 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 20 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR 21 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT 22 * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, 23 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT 24 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 25 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 26 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 27 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE 28 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 29 * 30 * --- 31 * Author: Sanjay Ghemawat <opensource@google.com> 32 * .h file by Craig Silverstein <opensource@google.com> 33 */ 34 35 #ifndef TCMALLOC_TCMALLOC_H_ 36 #define TCMALLOC_TCMALLOC_H_ 37 38 #include <stddef.h> // for size_t 39 #ifdef HAVE_SYS_CDEFS_H 40 #include <sys/cdefs.h> // where glibc defines __THROW 41 #endif 42 43 // __THROW is defined in glibc systems. It means, counter-intuitively, 44 // "This function will never throw an exception." It's an optional 45 // optimization tool, but we may need to use it to match glibc prototypes. 46 #ifndef __THROW /* I guess we're not on a glibc system */ 47 # define __THROW /* __THROW is just an optimization, so ok to make it "" */ 48 #endif 49 50 // Define the version number so folks can check against it 51 #define TC_VERSION_MAJOR 2 52 #define TC_VERSION_MINOR 0 53 #define TC_VERSION_PATCH "" 54 #define TC_VERSION_STRING "gperftools 2.0" 55 56 // For struct mallinfo, it it's defined. 57 #ifdef HAVE_STRUCT_MALLINFO 58 // Malloc can be in several places on older versions of OS X. 59 # if defined(HAVE_MALLOC_H) 60 # include <malloc.h> 61 # elif defined(HAVE_SYS_MALLOC_H) 62 # include <sys/malloc.h> 63 # elif defined(HAVE_MALLOC_MALLOC_H) 64 # include <malloc/malloc.h> 65 # endif 66 #endif 67 68 // Annoying stuff for windows -- makes sure clients can import these functions 69 #ifndef PERFTOOLS_DLL_DECL 70 # ifdef _WIN32 71 # define PERFTOOLS_DLL_DECL __declspec(dllimport) 72 # else 73 # define PERFTOOLS_DLL_DECL 74 # endif 75 #endif 76 77 #ifdef __cplusplus 78 namespace std { 79 struct nothrow_t; 80 } 81 82 extern "C" { 83 #endif 84 // Returns a human-readable version string. If major, minor, 85 // and/or patch are not NULL, they are set to the major version, 86 // minor version, and patch-code (a string, usually ""). 87 PERFTOOLS_DLL_DECL const char* tc_version(int* major, int* minor, 88 const char** patch) __THROW; 89 90 PERFTOOLS_DLL_DECL void* tc_malloc(size_t size) __THROW; 91 PERFTOOLS_DLL_DECL void tc_free(void* ptr) __THROW; 92 PERFTOOLS_DLL_DECL void* tc_realloc(void* ptr, size_t size) __THROW; 93 PERFTOOLS_DLL_DECL void* tc_calloc(size_t nmemb, size_t size) __THROW; 94 PERFTOOLS_DLL_DECL void tc_cfree(void* ptr) __THROW; 95 96 PERFTOOLS_DLL_DECL void* tc_memalign(size_t __alignment, 97 size_t __size) __THROW; 98 PERFTOOLS_DLL_DECL int tc_posix_memalign(void** ptr, 99 size_t align, size_t size) __THROW; 100 PERFTOOLS_DLL_DECL void* tc_valloc(size_t __size) __THROW; 101 PERFTOOLS_DLL_DECL void* tc_pvalloc(size_t __size) __THROW; 102 103 PERFTOOLS_DLL_DECL void tc_malloc_stats(void) __THROW; 104 PERFTOOLS_DLL_DECL int tc_mallopt(int cmd, int value) __THROW; 105 #ifdef HAVE_STRUCT_MALLINFO 106 PERFTOOLS_DLL_DECL struct mallinfo tc_mallinfo(void) __THROW; 107 #endif 108 109 // This is an alias for MallocExtension::instance()->GetAllocatedSize(). 110 // It is equivalent to 111 // OS X: malloc_size() 112 // glibc: malloc_usable_size() 113 // Windows: _msize() 114 PERFTOOLS_DLL_DECL size_t tc_malloc_size(void* ptr) __THROW; 115 116 #ifdef __cplusplus 117 PERFTOOLS_DLL_DECL int tc_set_new_mode(int flag) __THROW; 118 PERFTOOLS_DLL_DECL void* tc_new(size_t size); 119 PERFTOOLS_DLL_DECL void* tc_new_nothrow(size_t size, 120 const std::nothrow_t&) __THROW; 121 PERFTOOLS_DLL_DECL void tc_delete(void* p) __THROW; 122 PERFTOOLS_DLL_DECL void tc_delete_nothrow(void* p, 123 const std::nothrow_t&) __THROW; 124 PERFTOOLS_DLL_DECL void* tc_newarray(size_t size); 125 PERFTOOLS_DLL_DECL void* tc_newarray_nothrow(size_t size, 126 const std::nothrow_t&) __THROW; 127 PERFTOOLS_DLL_DECL void tc_deletearray(void* p) __THROW; 128 PERFTOOLS_DLL_DECL void tc_deletearray_nothrow(void* p, 129 const std::nothrow_t&) __THROW; 130 } 131 #endif 132 133 #endif // #ifndef TCMALLOC_TCMALLOC_H_ 134