| 1 |
# |
| 2 |
# Sample RC file for the debug malloc library |
| 3 |
# Rename this to .dmallocrc and place in your $HOME directory to |
| 4 |
# activate. See dmalloc.info for more information. |
| 5 |
# |
| 6 |
# $Id: dmallocrc,v 1.32 1998/11/12 21:42:31 gray Exp $ |
| 7 |
# |
| 8 |
|
| 9 |
# |
| 10 |
# This file maps tags to certain combinations of debug tokens. The |
| 11 |
# tags here are provided as an example. You can also roll your own. |
| 12 |
# Lines in this file should have the form: |
| 13 |
# |
| 14 |
# tag token1, token2, ... |
| 15 |
# |
| 16 |
# To use the above line you say 'dmalloc tag' which enables the |
| 17 |
# debugging facilities token1, token2, ... You must pass the output |
| 18 |
# from dmalloc through your shell's eval command to change your |
| 19 |
# environment. See malloc.info for more information. |
| 20 |
# |
| 21 |
# Lines can end with a \ meaning it continues onto the next line. |
| 22 |
# Lines beginning with '#' and empty lines are ignored |
| 23 |
# |
| 24 |
|
| 25 |
# |
| 26 |
# Token: Description: |
| 27 |
########################################################################### |
| 28 |
# none no debugging functionality |
| 29 |
# |
| 30 |
# log-stats log general statistics |
| 31 |
# log-non-free log non-freed memory pointers on shutdown |
| 32 |
# log-trans log memory transactions |
| 33 |
# log-admin log full administrative information |
| 34 |
# log-blocks log detailed block information in heap_map |
| 35 |
# log-unknown log unknown non-freed memory pointers too |
| 36 |
# log-bad-space log actual bytes from bad pointers |
| 37 |
# log-nonfree-space log actual bytes in non-freed pointers |
| 38 |
# log-elapsed-time log elapsed-time for allocated pointer |
| 39 |
# log-current-time log current-time for allocated pointers |
| 40 |
# |
| 41 |
# check-fence check fence-post areas |
| 42 |
# check-heap do general heap checking |
| 43 |
# check-lists verify internal heap linked-lists |
| 44 |
# check-blank check to see if blank space is overwritten |
| 45 |
# check-funcs check the arguments of some routines |
| 46 |
# |
| 47 |
# catch-signals shutdown the library on SIGHUP, SIGINT, SIGTERM |
| 48 |
# realloc-copy always copy data to a new pointer when realloc |
| 49 |
# free-blank overwrite space that is freed |
| 50 |
# error-abort abort the program (and dump core) on errors |
| 51 |
# alloc-blank blank space that is to be alloced |
| 52 |
# heap-check-map log a heap-map every time the heap is checked |
| 53 |
# print-messages print errors and messages to STDERR |
| 54 |
# catch-null abort program if library can't get sbrk space |
| 55 |
# never-reuse never reuse memory that has been freed |
| 56 |
# allow-nonlinear allow non-linear heap space |
| 57 |
# allow-free-null allow the freeing of NULL pointers |
| 58 |
# error-dump dump core on error and then continue |
| 59 |
# |
| 60 |
|
| 61 |
# no debugging (for disabling memory checking) |
| 62 |
none none |
| 63 |
|
| 64 |
# basic runtime tests |
| 65 |
runtime log-stats, log-non-free, log-blocks, log-bad-space, \ |
| 66 |
log-unknown, \ |
| 67 |
check-fence, \ |
| 68 |
catch-null |
| 69 |
|
| 70 |
# minimal checking |
| 71 |
low log-stats, log-non-free, log-blocks, log-bad-space, \ |
| 72 |
log-unknown, log-elapsed-time, \ |
| 73 |
check-fence, \ |
| 74 |
free-blank, error-abort, alloc-blank, catch-null |
| 75 |
|
| 76 |
# significant checking |
| 77 |
medium log-stats, log-non-free, log-blocks, log-bad-space, \ |
| 78 |
log-unknown, log-elapsed-time, \ |
| 79 |
check-fence, check-heap, check-lists, \ |
| 80 |
realloc-copy, free-blank, error-abort, alloc-blank, \ |
| 81 |
catch-null |
| 82 |
|
| 83 |
# extensive checking |
| 84 |
high log-stats, log-non-free, log-blocks, log-bad-space, \ |
| 85 |
log-unknown, log-elapsed-time, \ |
| 86 |
check-fence, check-heap, check-lists, check-blank, \ |
| 87 |
check-funcs, \ |
| 88 |
realloc-copy, free-blank, error-abort, alloc-blank, \ |
| 89 |
catch-null |
| 90 |
|
| 91 |
# full logging of statistics |
| 92 |
log log-stats, log-non-free, log-trans, log-admin, log-blocks, \ |
| 93 |
log-unknown, log-bad-space, log-elapsed-time, \ |
| 94 |
check-fence, \ |
| 95 |
catch-null |
| 96 |
|
| 97 |
# immediate logging of problems in a text-based programs |
| 98 |
text log-bad-space, log-unknown, \ |
| 99 |
check-fence, \ |
| 100 |
catch-null, print-messages |
| 101 |
|
| 102 |
# full logging of statistics in text programs |
| 103 |
verbose log-stats, log-non-free, log-trans, log-admin, log-blocks, \ |
| 104 |
log-unknown, log-bad-space, log-elapsed-time, \ |
| 105 |
check-fence, \ |
| 106 |
catch-null, print-messages |
| 107 |
|
| 108 |
# the kitchen-sink minus a couple special tokens: |
| 109 |
# log-current-time, print-messages, allow-nonlinear, allow-free-null, |
| 110 |
# error-dump |
| 111 |
all log-stats, log-non-free, log-trans, log-admin, log-blocks, \ |
| 112 |
log-unknown, log-bad-space, log-elapsed-time, \ |
| 113 |
check-fence, check-heap, check-lists, check-blank, \ |
| 114 |
check-funcs, \ |
| 115 |
catch-signals, realloc-copy, free-blank, error-abort, \ |
| 116 |
alloc-blank, heap-check-map, catch-null, never-reuse |