1#ifndef HEADER_CURL_MEMDEBUG_H 2#define HEADER_CURL_MEMDEBUG_H 3#ifdef CURLDEBUG 4/*************************************************************************** 5 * _ _ ____ _ 6 * Project ___| | | | _ \| | 7 * / __| | | | |_) | | 8 * | (__| |_| | _ <| |___ 9 * \___|\___/|_| \_\_____| 10 * 11 * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al. 12 * 13 * This software is licensed as described in the file COPYING, which 14 * you should have received as part of this distribution. The terms 15 * are also available at https://curl.se/docs/copyright.html. 16 * 17 * You may opt to use, copy, modify, merge, publish, distribute and/or sell 18 * copies of the Software, and permit persons to whom the Software is 19 * furnished to do so, under the terms of the COPYING file. 20 * 21 * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY 22 * KIND, either express or implied. 23 * 24 * SPDX-License-Identifier: curl 25 * 26 ***************************************************************************/ 27 28/* 29 * CAUTION: this header is designed to work when included by the app-side 30 * as well as the library. Do not mix with library internals! 31 */ 32 33#include <curl/curl.h> 34#include "functypes.h" 35 36#if defined(__GNUC__) && __GNUC__ >= 3 37# define ALLOC_FUNC __attribute__((malloc)) 38# define ALLOC_SIZE(s) __attribute__((alloc_size(s))) 39# define ALLOC_SIZE2(n, s) __attribute__((alloc_size(n, s))) 40#elif defined(_MSC_VER) 41# define ALLOC_FUNC __declspec(restrict) 42# define ALLOC_SIZE(s) 43# define ALLOC_SIZE2(n, s) 44#else 45# define ALLOC_FUNC 46# define ALLOC_SIZE(s) 47# define ALLOC_SIZE2(n, s) 48#endif 49 50#define CURL_MT_LOGFNAME_BUFSIZE 512 51 52extern FILE *curl_dbg_logfile; 53 54/* memory functions */ 55CURL_EXTERN ALLOC_FUNC ALLOC_SIZE(1) void *curl_dbg_malloc(size_t size, 56 int line, 57 const char *source); 58CURL_EXTERN ALLOC_FUNC ALLOC_SIZE2(1, 2) void *curl_dbg_calloc(size_t elements, 59 size_t size, int line, const char *source); 60CURL_EXTERN ALLOC_SIZE(2) void *curl_dbg_realloc(void *ptr, 61 size_t size, 62 int line, 63 const char *source); 64CURL_EXTERN void curl_dbg_free(void *ptr, int line, const char *source); 65CURL_EXTERN ALLOC_FUNC char *curl_dbg_strdup(const char *str, int line, 66 const char *src); 67#if defined(_WIN32) && defined(UNICODE) 68CURL_EXTERN ALLOC_FUNC wchar_t *curl_dbg_wcsdup(const wchar_t *str, 69 int line, 70 const char *source); 71#endif 72 73CURL_EXTERN void curl_dbg_memdebug(const char *logname); 74CURL_EXTERN void curl_dbg_memlimit(long limit); 75CURL_EXTERN void curl_dbg_log(const char *format, ...) CURL_PRINTF(1, 2); 76 77/* file descriptor manipulators */ 78CURL_EXTERN curl_socket_t curl_dbg_socket(int domain, int type, int protocol, 79 int line, const char *source); 80CURL_EXTERN void curl_dbg_mark_sclose(curl_socket_t sockfd, 81 int line, const char *source); 82CURL_EXTERN int curl_dbg_sclose(curl_socket_t sockfd, 83 int line, const char *source); 84CURL_EXTERN curl_socket_t curl_dbg_accept(curl_socket_t s, void *a, void *alen, 85 int line, const char *source); 86#ifdef HAVE_SOCKETPAIR 87CURL_EXTERN int curl_dbg_socketpair(int domain, int type, int protocol, 88 curl_socket_t socket_vector[2], 89 int line, const char *source); 90#endif 91 92/* send/receive sockets */ 93CURL_EXTERN SEND_TYPE_RETV curl_dbg_send(SEND_TYPE_ARG1 sockfd, 94 SEND_QUAL_ARG2 SEND_TYPE_ARG2 buf, 95 SEND_TYPE_ARG3 len, 96 SEND_TYPE_ARG4 flags, int line, 97 const char *source); 98CURL_EXTERN RECV_TYPE_RETV curl_dbg_recv(RECV_TYPE_ARG1 sockfd, 99 RECV_TYPE_ARG2 buf, 100 RECV_TYPE_ARG3 len, 101 RECV_TYPE_ARG4 flags, int line, 102 const char *source); 103 104/* FILE functions */ 105CURL_EXTERN ALLOC_FUNC FILE *curl_dbg_fopen(const char *file, const char *mode, 106 int line, const char *source); 107CURL_EXTERN ALLOC_FUNC FILE *curl_dbg_fdopen(int filedes, const char *mode, 108 int line, const char *source); 109 110CURL_EXTERN int curl_dbg_fclose(FILE *file, int line, const char *source); 111 112#ifndef MEMDEBUG_NODEFINES 113 114/* Set this symbol on the command-line, recompile all lib-sources */ 115#undef strdup 116#define strdup(ptr) curl_dbg_strdup(ptr, __LINE__, __FILE__) 117#define malloc(size) curl_dbg_malloc(size, __LINE__, __FILE__) 118#define calloc(nbelem,size) curl_dbg_calloc(nbelem, size, __LINE__, __FILE__) 119#define realloc(ptr,size) curl_dbg_realloc(ptr, size, __LINE__, __FILE__) 120#define free(ptr) curl_dbg_free(ptr, __LINE__, __FILE__) 121#define send(a,b,c,d) curl_dbg_send(a,b,c,d, __LINE__, __FILE__) 122#define recv(a,b,c,d) curl_dbg_recv(a,b,c,d, __LINE__, __FILE__) 123 124#ifdef _WIN32 125# ifdef UNICODE 126# undef wcsdup 127# define wcsdup(ptr) curl_dbg_wcsdup(ptr, __LINE__, __FILE__) 128# undef _wcsdup 129# define _wcsdup(ptr) curl_dbg_wcsdup(ptr, __LINE__, __FILE__) 130# undef _tcsdup 131# define _tcsdup(ptr) curl_dbg_wcsdup(ptr, __LINE__, __FILE__) 132# else 133# undef _tcsdup 134# define _tcsdup(ptr) curl_dbg_strdup(ptr, __LINE__, __FILE__) 135# endif 136#endif 137 138#undef socket 139#define socket(domain,type,protocol)\ 140 curl_dbg_socket(domain, type, protocol, __LINE__, __FILE__) 141#undef accept /* for those with accept as a macro */ 142#define accept(sock,addr,len)\ 143 curl_dbg_accept(sock, addr, len, __LINE__, __FILE__) 144#ifdef HAVE_SOCKETPAIR 145#define socketpair(domain,type,protocol,socket_vector)\ 146 curl_dbg_socketpair(domain, type, protocol, socket_vector, __LINE__, __FILE__) 147#endif 148 149#ifdef HAVE_GETADDRINFO 150#if defined(getaddrinfo) && defined(__osf__) 151/* OSF/1 and Tru64 have getaddrinfo as a define already, so we cannot define 152 our macro as for other platforms. Instead, we redefine the new name they 153 define getaddrinfo to become! */ 154#define ogetaddrinfo(host,serv,hint,res) \ 155 curl_dbg_getaddrinfo(host, serv, hint, res, __LINE__, __FILE__) 156#else 157#undef getaddrinfo 158#define getaddrinfo(host,serv,hint,res) \ 159 curl_dbg_getaddrinfo(host, serv, hint, res, __LINE__, __FILE__) 160#endif 161#endif /* HAVE_GETADDRINFO */ 162 163#ifdef HAVE_FREEADDRINFO 164#undef freeaddrinfo 165#define freeaddrinfo(data) \ 166 curl_dbg_freeaddrinfo(data, __LINE__, __FILE__) 167#endif /* HAVE_FREEADDRINFO */ 168 169/* sclose is probably already defined, redefine it! */ 170#undef sclose 171#define sclose(sockfd) curl_dbg_sclose(sockfd,__LINE__,__FILE__) 172 173#define fake_sclose(sockfd) curl_dbg_mark_sclose(sockfd,__LINE__,__FILE__) 174 175#undef fopen 176#define fopen(file,mode) curl_dbg_fopen(file,mode,__LINE__,__FILE__) 177#undef fdopen 178#define fdopen(file,mode) curl_dbg_fdopen(file,mode,__LINE__,__FILE__) 179#define fclose(file) curl_dbg_fclose(file,__LINE__,__FILE__) 180 181#endif /* MEMDEBUG_NODEFINES */ 182 183#endif /* CURLDEBUG */ 184 185/* 186** Following section applies even when CURLDEBUG is not defined. 187*/ 188 189#ifndef fake_sclose 190#define fake_sclose(x) Curl_nop_stmt 191#endif 192 193/* 194 * Curl_safefree defined as a macro to allow MemoryTracking feature 195 * to log free() calls at same location where Curl_safefree is used. 196 * This macro also assigns NULL to given pointer when free'd. 197 */ 198 199#define Curl_safefree(ptr) \ 200 do { free((ptr)); (ptr) = NULL;} while(0) 201 202#endif /* HEADER_CURL_MEMDEBUG_H */ 203