crypto/mem_dbg.c

   1 /*
   2  * Copyright 1995-2019 The OpenSSL Project Authors. All Rights Reserved.
   3  *
   4  * Licensed under the Apache License 2.0 (the "License").  You may not use
   5  * this file except in compliance with the License.  You can obtain a copy
   6  * in the file LICENSE in the source distribution or at
   7  * https://www.openssl.org/source/license.html
   8  */
   9
  10 #include <stdio.h>
  11 #include <stdlib.h>
  12 #include <time.h>
  13 #include "internal/cryptlib.h"
  14 #include "internal/thread_once.h"
  15 #include <openssl/crypto.h>
  16 #include <openssl/buffer.h>
  17 #include "internal/bio.h"
  18 #include <openssl/lhash.h>
  19
  20 #ifndef OPENSSL_NO_CRYPTO_MDEBUG_BACKTRACE
  21 # include <execinfo.h>
  22 #endif
  23
  24 /*
  25  * The state changes to CRYPTO_MEM_CHECK_ON | CRYPTO_MEM_CHECK_ENABLE when
  26  * the application asks for it (usually after library initialisation for
  27  * which no book-keeping is desired). State CRYPTO_MEM_CHECK_ON exists only
  28  * temporarily when the library thinks that certain allocations should not be
  29  * checked (e.g. the data structures used for memory checking).  It is not
  30  * suitable as an initial state: the library will unexpectedly enable memory
  31  * checking when it executes one of those sections that want to disable
  32  * checking temporarily. State CRYPTO_MEM_CHECK_ENABLE without ..._ON makes
  33  * no sense whatsoever.
  34  */
  35 #ifndef OPENSSL_NO_CRYPTO_MDEBUG
  36 static int mh_mode = CRYPTO_MEM_CHECK_OFF;
  37 #endif
  38
  39 #ifndef OPENSSL_NO_CRYPTO_MDEBUG
  40 static unsigned long order = 0; /* number of memory requests */
  41
  42 /*-
  43  * For application-defined information (static C-string `info')
  44  * to be displayed in memory leak list.
  45  * Each thread has its own stack.  For applications, there is
  46  *   OPENSSL_mem_debug_push("...")     to push an entry,
  47  *   OPENSSL_mem_debug_pop()     to pop an entry,
  48  */
  49 struct app_mem_info_st {
  50     CRYPTO_THREAD_ID threadid;
  51     const char *file;
  52     int line;
  53     const char *info;
  54     struct app_mem_info_st *next; /* tail of thread's stack */
  55     int references;
  56 };
  57
  58 static CRYPTO_ONCE memdbg_init = CRYPTO_ONCE_STATIC_INIT;
  59 CRYPTO_RWLOCK *memdbg_lock;
  60 static CRYPTO_RWLOCK *long_memdbg_lock;
  61 static CRYPTO_THREAD_LOCAL appinfokey;
  62
  63 /* memory-block description */
  64 struct mem_st {
  65     void *addr;
  66     int num;
  67     const char *file;
  68     int line;
  69     CRYPTO_THREAD_ID threadid;
  70     unsigned long order;
  71     time_t time;
  72     APP_INFO *app_info;
  73 #ifndef OPENSSL_NO_CRYPTO_MDEBUG_BACKTRACE
  74     void *array[30];
  75     size_t array_siz;
  76 #endif
  77 };
  78
  79 /*
  80  * hash-table of memory requests (address as * key); access requires
  81  * long_memdbg_lock lock
  82  */
  83 static LHASH_OF(MEM) *mh = NULL;
  84
  85 /* num_disable > 0 iff mh_mode == CRYPTO_MEM_CHECK_ON (w/o ..._ENABLE) */
  86 static unsigned int num_disable = 0;
  87
  88 /*
  89  * Valid iff num_disable > 0.  long_memdbg_lock is locked exactly in this
  90  * case (by the thread named in disabling_thread).
  91  */
  92 static CRYPTO_THREAD_ID disabling_threadid;
  93
  94 DEFINE_RUN_ONCE_STATIC(do_memdbg_init)
  95 {
  96     memdbg_lock = CRYPTO_THREAD_lock_new();
  97     long_memdbg_lock = CRYPTO_THREAD_lock_new();
  98     if (memdbg_lock == NULL || long_memdbg_lock == NULL
  99         || !CRYPTO_THREAD_init_local(&appinfokey, NULL)) {
 100         CRYPTO_THREAD_lock_free(memdbg_lock);
 101         memdbg_lock = NULL;
 102         CRYPTO_THREAD_lock_free(long_memdbg_lock);
 103         long_memdbg_lock = NULL;
 104         return 0;
 105     }
 106     return 1;
 107 }
 108
 109 static void app_info_free(APP_INFO *inf)
 110 {
 111     if (inf == NULL)
 112         return;
 113     if (--(inf->references) <= 0) {
 114         app_info_free(inf->next);
 115         OPENSSL_free(inf);
 116     }
 117 }
 118 #endif
 119
 120 int CRYPTO_mem_ctrl(int mode)
 121 {
 122 #ifdef OPENSSL_NO_CRYPTO_MDEBUG
 123     return mode - mode;
 124 #else
 125     int ret = mh_mode;
 126
 127     if (!RUN_ONCE(&memdbg_init, do_memdbg_init))
 128         return -1;
 129
 130     CRYPTO_THREAD_write_lock(memdbg_lock);
 131     switch (mode) {
 132     default:
 133         break;
 134
 135     case CRYPTO_MEM_CHECK_ON:
 136         mh_mode = CRYPTO_MEM_CHECK_ON | CRYPTO_MEM_CHECK_ENABLE;
 137         num_disable = 0;
 138         break;
 139
 140     case CRYPTO_MEM_CHECK_OFF:
 141         mh_mode = 0;
 142         num_disable = 0;
 143         break;
 144
 145     /* switch off temporarily (for library-internal use): */
 146     case CRYPTO_MEM_CHECK_DISABLE:
 147         if (mh_mode & CRYPTO_MEM_CHECK_ON) {
 148             CRYPTO_THREAD_ID cur = CRYPTO_THREAD_get_current_id();
 149             /* see if we don't have long_memdbg_lock already */
 150             if (!num_disable
 151                 || !CRYPTO_THREAD_compare_id(disabling_threadid, cur)) {
 152                 /*
 153                  * Long-time lock long_memdbg_lock must not be claimed
 154                  * while we're holding memdbg_lock, or we'll deadlock
 155                  * if somebody else holds long_memdbg_lock (and cannot
 156                  * release it because we block entry to this function). Give
 157                  * them a chance, first, and then claim the locks in
 158                  * appropriate order (long-time lock first).
 159                  */
 160                 CRYPTO_THREAD_unlock(memdbg_lock);
 161                 /*
 162                  * Note that after we have waited for long_memdbg_lock and
 163                  * memdbg_lock, we'll still be in the right "case" and
 164                  * "if" branch because MemCheck_start and MemCheck_stop may
 165                  * never be used while there are multiple OpenSSL threads.
 166                  */
 167                 CRYPTO_THREAD_write_lock(long_memdbg_lock);
 168                 CRYPTO_THREAD_write_lock(memdbg_lock);
 169                 mh_mode &= ~CRYPTO_MEM_CHECK_ENABLE;
 170                 disabling_threadid = cur;
 171             }
 172             num_disable++;
 173         }
 174         break;
 175
 176     case CRYPTO_MEM_CHECK_ENABLE:
 177         if (mh_mode & CRYPTO_MEM_CHECK_ON) {
 178             if (num_disable) {  /* always true, or something is going wrong */
 179                 num_disable--;
 180                 if (num_disable == 0) {
 181                     mh_mode |= CRYPTO_MEM_CHECK_ENABLE;
 182                     CRYPTO_THREAD_unlock(long_memdbg_lock);
 183                 }
 184             }
 185         }
 186         break;
 187     }
 188     CRYPTO_THREAD_unlock(memdbg_lock);
 189     return ret;
 190 #endif
 191 }
 192
 193 #ifndef OPENSSL_NO_CRYPTO_MDEBUG
 194
 195 static int mem_check_on(void)
 196 {
 197     int ret = 0;
 198     CRYPTO_THREAD_ID cur;
 199
 200     if (mh_mode & CRYPTO_MEM_CHECK_ON) {
 201         if (!RUN_ONCE(&memdbg_init, do_memdbg_init))
 202             return 0;
 203
 204         cur = CRYPTO_THREAD_get_current_id();
 205         CRYPTO_THREAD_read_lock(memdbg_lock);
 206
 207         ret = (mh_mode & CRYPTO_MEM_CHECK_ENABLE)
 208             || !CRYPTO_THREAD_compare_id(disabling_threadid, cur);
 209
 210         CRYPTO_THREAD_unlock(memdbg_lock);
 211     }
 212     return ret;
 213 }
 214
 215 static int mem_cmp(const MEM *a, const MEM *b)
 216 {
 217 #ifdef _WIN64
 218     const char *ap = (const char *)a->addr, *bp = (const char *)b->addr;
 219     if (ap == bp)
 220         return 0;
 221     else if (ap > bp)
 222         return 1;
 223     else
 224         return -1;
 225 #else
 226     return (const char *)a->addr - (const char *)b->addr;
 227 #endif
 228 }
 229
 230 static unsigned long mem_hash(const MEM *a)
 231 {
 232     size_t ret;
 233
 234     ret = (size_t)a->addr;
 235
 236     ret = ret * 17851 + (ret >> 14) * 7 + (ret >> 4) * 251;
 237     return ret;
 238 }
 239
 240 /* returns 1 if there was an info to pop, 0 if the stack was empty. */
 241 static int pop_info(void)
 242 {
 243     APP_INFO *current = NULL;
 244
 245     if (!RUN_ONCE(&memdbg_init, do_memdbg_init))
 246         return 0;
 247
 248     current = (APP_INFO *)CRYPTO_THREAD_get_local(&appinfokey);
 249     if (current != NULL) {
 250         APP_INFO *next = current->next;
 251
 252         if (next != NULL) {
 253             next->references++;
 254             CRYPTO_THREAD_set_local(&appinfokey, next);
 255         } else {
 256             CRYPTO_THREAD_set_local(&appinfokey, NULL);
 257         }
 258         if (--(current->references) <= 0) {
 259             current->next = NULL;
 260             if (next != NULL)
 261                 next->references--;
 262             OPENSSL_free(current);
 263         }
 264         return 1;
 265     }
 266     return 0;
 267 }
 268
 269 int CRYPTO_mem_debug_push(const char *info, const char *file, int line)
 270 {
 271     APP_INFO *ami, *amim;
 272     int ret = 0;
 273
 274     if (mem_check_on()) {
 275         CRYPTO_mem_ctrl(CRYPTO_MEM_CHECK_DISABLE);
 276
 277         if (!RUN_ONCE(&memdbg_init, do_memdbg_init)
 278             || (ami = OPENSSL_malloc(sizeof(*ami))) == NULL)
 279             goto err;
 280
 281         ami->threadid = CRYPTO_THREAD_get_current_id();
 282         ami->file = file;
 283         ami->line = line;
 284         ami->info = info;
 285         ami->references = 1;
 286         ami->next = NULL;
 287
 288         amim = (APP_INFO *)CRYPTO_THREAD_get_local(&appinfokey);
 289         CRYPTO_THREAD_set_local(&appinfokey, ami);
 290
 291         if (amim != NULL)
 292             ami->next = amim;
 293         ret = 1;
 294  err:
 295         CRYPTO_mem_ctrl(CRYPTO_MEM_CHECK_ENABLE);
 296     }
 297
 298     return ret;
 299 }
 300
 301 int CRYPTO_mem_debug_pop(void)
 302 {
 303     int ret = 0;
 304
 305     if (mem_check_on()) {
 306         CRYPTO_mem_ctrl(CRYPTO_MEM_CHECK_DISABLE);
 307         ret = pop_info();
 308         CRYPTO_mem_ctrl(CRYPTO_MEM_CHECK_ENABLE);
 309     }
 310     return ret;
 311 }
 312
 313 static unsigned long break_order_num = 0;
 314
 315 void CRYPTO_mem_debug_malloc(void *addr, size_t num, int before_p,
 316                              const char *file, int line)
 317 {
 318     MEM *m, *mm;
 319     APP_INFO *amim;
 320
 321     switch (before_p & 127) {
 322     case 0:
 323         break;
 324     case 1:
 325         if (addr == NULL)
 326             break;
 327
 328         if (mem_check_on()) {
 329             CRYPTO_mem_ctrl(CRYPTO_MEM_CHECK_DISABLE);
 330
 331             if (!RUN_ONCE(&memdbg_init, do_memdbg_init)
 332                 || (m = OPENSSL_malloc(sizeof(*m))) == NULL) {
 333                 OPENSSL_free(addr);
 334                 CRYPTO_mem_ctrl(CRYPTO_MEM_CHECK_ENABLE);
 335                 return;
 336             }
 337             if (mh == NULL) {
 338                 if ((mh = lh_MEM_new(mem_hash, mem_cmp)) == NULL) {
 339                     OPENSSL_free(addr);
 340                     OPENSSL_free(m);
 341                     addr = NULL;
 342                     goto err;
 343                 }
 344             }
 345
 346             m->addr = addr;
 347             m->file = file;
 348             m->line = line;
 349             m->num = num;
 350             m->threadid = CRYPTO_THREAD_get_current_id();
 351
 352             if (order == break_order_num) {
 353                 /* BREAK HERE */
 354                 m->order = order;
 355             }
 356             m->order = order++;
 357 # ifndef OPENSSL_NO_CRYPTO_MDEBUG_BACKTRACE
 358             m->array_siz = backtrace(m->array, OSSL_NELEM(m->array));
 359 # endif
 360             m->time = time(NULL);
 361
 362             amim = (APP_INFO *)CRYPTO_THREAD_get_local(&appinfokey);
 363             m->app_info = amim;
 364             if (amim != NULL)
 365                 amim->references++;
 366
 367             if ((mm = lh_MEM_insert(mh, m)) != NULL) {
 368                 /* Not good, but don't sweat it */
 369                 if (mm->app_info != NULL) {
 370                     mm->app_info->references--;
 371                 }
 372                 OPENSSL_free(mm);
 373             }
 374  err:
 375             CRYPTO_mem_ctrl(CRYPTO_MEM_CHECK_ENABLE);
 376         }
 377         break;
 378     }
 379     return;
 380 }
 381
 382 void CRYPTO_mem_debug_free(void *addr, int before_p,
 383         const char *file, int line)
 384 {
 385     MEM m, *mp;
 386
 387     switch (before_p) {
 388     case 0:
 389         if (addr == NULL)
 390             break;
 391
 392         if (mem_check_on() && (mh != NULL)) {
 393             CRYPTO_mem_ctrl(CRYPTO_MEM_CHECK_DISABLE);
 394
 395             m.addr = addr;
 396             mp = lh_MEM_delete(mh, &m);
 397             if (mp != NULL) {
 398                 app_info_free(mp->app_info);
 399                 OPENSSL_free(mp);
 400             }
 401
 402             CRYPTO_mem_ctrl(CRYPTO_MEM_CHECK_ENABLE);
 403         }
 404         break;
 405     case 1:
 406         break;
 407     }
 408 }
 409
 410 void CRYPTO_mem_debug_realloc(void *addr1, void *addr2, size_t num,
 411                               int before_p, const char *file, int line)
 412 {
 413     MEM m, *mp;
 414
 415     switch (before_p) {
 416     case 0:
 417         break;
 418     case 1:
 419         if (addr2 == NULL)
 420             break;
 421
 422         if (addr1 == NULL) {
 423             CRYPTO_mem_debug_malloc(addr2, num, 128 | before_p, file, line);
 424             break;
 425         }
 426
 427         if (mem_check_on()) {
 428             CRYPTO_mem_ctrl(CRYPTO_MEM_CHECK_DISABLE);
 429
 430             m.addr = addr1;
 431             mp = lh_MEM_delete(mh, &m);
 432             if (mp != NULL) {
 433                 mp->addr = addr2;
 434                 mp->num = num;
 435 #ifndef OPENSSL_NO_CRYPTO_MDEBUG_BACKTRACE
 436                 mp->array_siz = backtrace(mp->array, OSSL_NELEM(mp->array));
 437 #endif
 438                 (void)lh_MEM_insert(mh, mp);
 439             }
 440
 441             CRYPTO_mem_ctrl(CRYPTO_MEM_CHECK_ENABLE);
 442         }
 443         break;
 444     }
 445     return;
 446 }
 447
 448 typedef struct mem_leak_st {
 449     int (*print_cb) (const char *str, size_t len, void *u);
 450     void *print_cb_arg;
 451     int chunks;
 452     long bytes;
 453 } MEM_LEAK;
 454
 455 static void print_leak(const MEM *m, MEM_LEAK *l)
 456 {
 457     char buf[1024];
 458     char *bufp = buf, *hex;
 459     size_t len = sizeof(buf), ami_cnt;
 460     APP_INFO *amip;
 461     int n;
 462     struct tm *lcl = NULL;
 463     CRYPTO_THREAD_ID ti;
 464
 465     lcl = localtime(&m->time);
 466     n = BIO_snprintf(bufp, len, "[%02d:%02d:%02d] ",
 467                      lcl->tm_hour, lcl->tm_min, lcl->tm_sec);
 468     if (n <= 0) {
 469         bufp[0] = '\0';
 470         return;
 471     }
 472     bufp += n;
 473     len -= n;
 474
 475     n = BIO_snprintf(bufp, len, "%5lu file=%s, line=%d, ",
 476                      m->order, m->file, m->line);
 477     if (n <= 0)
 478         return;
 479     bufp += n;
 480     len -= n;
 481
 482     hex = OPENSSL_buf2hexstr((const unsigned char *)&m->threadid,
 483                              sizeof(m->threadid));
 484     n = BIO_snprintf(bufp, len, "thread=%s, number=%d, address=%p\n", hex,
 485                      m->num, m->addr);
 486     OPENSSL_free(hex);
 487     if (n <= 0)
 488         return;
 489     bufp += n;
 490     len -= n;
 491
 492     l->print_cb(buf, (size_t)(bufp - buf), l->print_cb_arg);
 493
 494     l->chunks++;
 495     l->bytes += m->num;
 496
 497     amip = m->app_info;
 498     ami_cnt = 0;
 499
 500     if (amip) {
 501         ti = amip->threadid;
 502
 503         do {
 504             int buf_len;
 505             int info_len;
 506
 507             ami_cnt++;
 508             if (ami_cnt >= sizeof(buf) - 1)
 509                 break;
 510             memset(buf, '>', ami_cnt);
 511             buf[ami_cnt] = '\0';
 512             hex = OPENSSL_buf2hexstr((const unsigned char *)&amip->threadid,
 513                                      sizeof(amip->threadid));
 514             n = BIO_snprintf(buf + ami_cnt, sizeof(buf) - ami_cnt,
 515                              "thread=%s, file=%s, line=%d, info=\"",
 516                              hex, amip->file, amip->line);
 517             OPENSSL_free(hex);
 518             if (n <= 0)
 519                 break;
 520             buf_len = ami_cnt + n;
 521             info_len = strlen(amip->info);
 522             if (128 - buf_len - 3 < info_len) {
 523                 memcpy(buf + buf_len, amip->info, 128 - buf_len - 3);
 524                 buf_len = 128 - 3;
 525             } else {
 526                 n = BIO_snprintf(buf + buf_len, sizeof(buf) - buf_len, "%s",
 527                                  amip->info);
 528                 if (n < 0)
 529                     break;
 530                 buf_len += n;
 531             }
 532             n = BIO_snprintf(buf + buf_len, sizeof(buf) - buf_len, "\"\n");
 533             if (n <= 0)
 534                 break;
 535
 536             l->print_cb(buf, buf_len + n, l->print_cb_arg);
 537
 538             amip = amip->next;
 539         }
 540         while (amip && CRYPTO_THREAD_compare_id(amip->threadid, ti));
 541     }
 542
 543 #ifndef OPENSSL_NO_CRYPTO_MDEBUG_BACKTRACE
 544     {
 545         size_t i;
 546         char **strings = backtrace_symbols(m->array, m->array_siz);
 547
 548         for (i = 0; i < m->array_siz; i++)
 549             fprintf(stderr, "##> %s\n", strings[i]);
 550         free(strings);
 551     }
 552 #endif
 553 }
 554
 555 IMPLEMENT_LHASH_DOALL_ARG_CONST(MEM, MEM_LEAK);
 556
 557 int CRYPTO_mem_leaks_cb(int (*cb) (const char *str, size_t len, void *u),
 558                         void *u)
 559 {
 560     MEM_LEAK ml;
 561
 562     /* Ensure all resources are released */
 563     OPENSSL_cleanup();
 564
 565     if (!RUN_ONCE(&memdbg_init, do_memdbg_init))
 566         return -1;
 567
 568     CRYPTO_mem_ctrl(CRYPTO_MEM_CHECK_DISABLE);
 569
 570     ml.print_cb = cb;
 571     ml.print_cb_arg = u;
 572     ml.bytes = 0;
 573     ml.chunks = 0;
 574     if (mh != NULL)
 575         lh_MEM_doall_MEM_LEAK(mh, print_leak, &ml);
 576
 577     if (ml.chunks != 0) {
 578         char buf[256];
 579
 580         BIO_snprintf(buf, sizeof(buf), "%ld bytes leaked in %d chunks\n",
 581                      ml.bytes, ml.chunks);
 582         cb(buf, strlen(buf), u);
 583     } else {
 584         /*
 585          * Make sure that, if we found no leaks, memory-leak debugging itself
 586          * does not introduce memory leaks (which might irritate external
 587          * debugging tools). (When someone enables leak checking, but does not
 588          * call this function, we declare it to be their fault.)
 589          */
 590         int old_mh_mode;
 591
 592         CRYPTO_THREAD_write_lock(memdbg_lock);
 593
 594         /*
 595          * avoid deadlock when lh_free() uses CRYPTO_mem_debug_free(), which uses
 596          * mem_check_on
 597          */
 598         old_mh_mode = mh_mode;
 599         mh_mode = CRYPTO_MEM_CHECK_OFF;
 600
 601         lh_MEM_free(mh);
 602         mh = NULL;
 603
 604         mh_mode = old_mh_mode;
 605         CRYPTO_THREAD_unlock(memdbg_lock);
 606     }
 607     CRYPTO_mem_ctrl(CRYPTO_MEM_CHECK_OFF);
 608
 609     /* Clean up locks etc */
 610     CRYPTO_THREAD_cleanup_local(&appinfokey);
 611     CRYPTO_THREAD_lock_free(memdbg_lock);
 612     CRYPTO_THREAD_lock_free(long_memdbg_lock);
 613     memdbg_lock = NULL;
 614     long_memdbg_lock = NULL;
 615
 616     return ml.chunks == 0 ? 1 : 0;
 617 }
 618
 619 static int print_bio(const char *str, size_t len, void *b)
 620 {
 621     return BIO_write((BIO *)b, str, len);
 622 }
 623
 624 int CRYPTO_mem_leaks(BIO *b)
 625 {
 626     /*
 627      * OPENSSL_cleanup() will free the ex_data locks so we can't have any
 628      * ex_data hanging around
 629      */
 630     bio_free_ex_data(b);
 631
 632     return CRYPTO_mem_leaks_cb(print_bio, b);
 633 }
 634
 635 # ifndef OPENSSL_NO_STDIO
 636 int CRYPTO_mem_leaks_fp(FILE *fp)
 637 {
 638     BIO *b;
 639     int ret;
 640
 641     /*
 642      * Need to turn off memory checking when allocated BIOs ... especially as
 643      * we're creating them at a time when we're trying to check we've not
 644      * left anything un-free()'d!!
 645      */
 646     CRYPTO_mem_ctrl(CRYPTO_MEM_CHECK_DISABLE);
 647     b = BIO_new(BIO_s_file());
 648     CRYPTO_mem_ctrl(CRYPTO_MEM_CHECK_ENABLE);
 649     if (b == NULL)
 650         return -1;
 651     BIO_set_fp(b, fp, BIO_NOCLOSE);
 652     ret = CRYPTO_mem_leaks_cb(print_bio, b);
 653     BIO_free(b);
 654     return ret;
 655 }
 656 # endif
 657
 658 #endif