vld.ini 6.2 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171
  1. ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
  2. ;;
  3. ;; Visual Leak Detector - Initialization/Configuration File
  4. ;; Copyright (c) 2005-2017 VLD Team
  5. ;;
  6. ;; This library is free software; you can redistribute it and/or
  7. ;; modify it under the terms of the GNU Lesser General Public
  8. ;; License as published by the Free Software Foundation; either
  9. ;; version 2.1 of the License, or (at your option) any later version.
  10. ;;
  11. ;; This library is distributed in the hope that it will be useful,
  12. ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
  13. ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
  14. ;; Lesser General Public License for more details.
  15. ;;
  16. ;; You should have received a copy of the GNU Lesser General Public
  17. ;; License along with this library; if not, write to the Free Software
  18. ;; Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
  19. ;;
  20. ;; See COPYING.txt for the full terms of the GNU Lesser General Public License.
  21. ;;
  22. ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
  23. ; Any options left blank or not present will revert to their default values.
  24. [Options]
  25. ; The main on/off switch. If off, Visual Leak Detector will be completely
  26. ; disabled. It will do nothing but print a message to the debugger indicating
  27. ; that it has been turned off.
  28. ;
  29. ; Valid Values: on, off
  30. ; Default: on
  31. ;
  32. VLD = on
  33. ; If yes, duplicate leaks (those that are identical) are not shown individually.
  34. ; Only the first such leak is shown, along with a number indicating the total
  35. ; number of duplicate leaks.
  36. ;
  37. ; Valid Values: yes, no
  38. ; Default: no
  39. ;
  40. AggregateDuplicates = no
  41. ; Lists any additional modules to be included in memory leak detection. This can
  42. ; be useful for checking for memory leaks in debug builds of 3rd party modules
  43. ; which can not be easily rebuilt with '#include "vld.h"'. This option should be
  44. ; used only if absolutely necessary and only if you really know what you are
  45. ; doing.
  46. ;
  47. ; CAUTION: Avoid listing any modules that link with the release CRT libraries.
  48. ; Only modules that link with the debug CRT libraries should be listed here.
  49. ; Doing otherwise might result in false memory leak reports or even crashes.
  50. ;
  51. ; Valid Values: Any list containing module names (i.e. names of EXEs or DLLs)
  52. ; Default: None.
  53. ;
  54. ForceIncludeModules =
  55. ; Maximum number of data bytes to display for each leaked block. If zero, then
  56. ; the data dump is completely suppressed and only call stacks are shown.
  57. ; Limiting this to a low number can be useful if any of the leaked blocks are
  58. ; very large and cause unnecessary clutter in the memory leak report.
  59. ;
  60. ; Value Values: 0 - 4294967295
  61. ; Default: 256
  62. ;
  63. MaxDataDump =
  64. ; Maximum number of call stack frames to trace back during leak detection.
  65. ; Limiting this to a low number can reduce the CPU utilization overhead imposed
  66. ; by memory leak detection, especially when using the slower "safe" stack
  67. ; walking method (see StackWalkMethod below).
  68. ;
  69. ; Valid Values: 1 - 4294967295
  70. ; Default: 64
  71. ;
  72. MaxTraceFrames =
  73. ; Sets the type of encoding to use for the generated memory leak report. This
  74. ; option is really only useful in conjuction with sending the report to a file.
  75. ; Sending a Unicode encoded report to the debugger is not useful because the
  76. ; debugger cannot display Unicode characters. Using Unicode encoding might be
  77. ; useful if the data contained in leaked blocks is likely to consist of Unicode
  78. ; text.
  79. ;
  80. ; Valid Values: ascii, unicode
  81. ; Default: ascii
  82. ;
  83. ReportEncoding = ascii
  84. ; Sets the report file destination, if reporting to file is enabled. A relative
  85. ; path may be specified and is considered relative to the process' working
  86. ; directory.
  87. ;
  88. ; Valid Values: Any valid path and filename.
  89. ; Default: .\memory_leak_report.txt
  90. ;
  91. ReportFile =
  92. ; Sets the report destination to either a file, the debugger, or both. If
  93. ; reporting to file is enabled, the report is sent to the file specified by the
  94. ; ReportFile option.
  95. ;
  96. ; Valid Values: debugger, file, both
  97. ; Default: debugger
  98. ;
  99. ReportTo = debugger
  100. ; Turns on or off a self-test mode which is used to verify that VLD is able to
  101. ; detect memory leaks in itself. Intended to be used for debugging VLD itself,
  102. ; not for debugging other programs.
  103. ;
  104. ; Valid Values: on, off
  105. ; Default: off
  106. ;
  107. SelfTest = off
  108. ; Selects the method to be used for walking the stack to obtain stack traces for
  109. ; allocated memory blocks. The "fast" method may not always be able to
  110. ; successfully trace completely through all call stacks. In such cases, the
  111. ; "safe" method may prove to more reliably obtain the full stack trace. The
  112. ; disadvantage is that the "safe" method is significantly slower than the "fast"
  113. ; method and will probably result in very noticeable performance degradation of
  114. ; the program being debugged.
  115. ;
  116. ; Valid Values: fast, safe
  117. ; Default: fast
  118. ;
  119. StackWalkMethod = fast
  120. ; Determines whether memory leak detection should be initially enabled for all
  121. ; threads, or whether it should be initially disabled for all threads. If set
  122. ; to "yes", then any threads requiring memory leak detection to be enabled will
  123. ; need to call VLDEnable at some point to enable leak detection for those
  124. ; threads.
  125. ;
  126. ; Valid Values: yes, no
  127. ; Default: no
  128. ;
  129. StartDisabled = no
  130. ; Determines whether or not all frames, including frames internal to the heap,
  131. ; are traced. There will always be a number of frames internal to Visual Leak
  132. ; Detector and C/C++ or Win32 heap APIs that aren't generally useful for
  133. ; determining the cause of a leak. Normally these frames are skipped during the
  134. ; stack trace, which somewhat reduces the time spent tracing and amount of data
  135. ; collected and stored in memory. Including all frames in the stack trace, all
  136. ; the way down into VLD's own code can, however, be useful for debugging VLD
  137. ; itself.
  138. ;
  139. ; Valid Values: yes, no
  140. ; Default: no
  141. ;
  142. TraceInternalFrames = no
  143. ; Determines whether or not report memory leaks when missing HeapFree calls.
  144. ;
  145. ; Valid Values: yes, no
  146. ; Default: no
  147. ;
  148. SkipHeapFreeLeaks = no
  149. ; Determines whether or not report memory leaks generated from crt startup code.
  150. ; These are not actual memory leaks as they are freed by crt after the VLD object
  151. ; has been destroyed.
  152. ;
  153. ; Valid Values: yes, no
  154. ; Default: yes
  155. ;
  156. SkipCrtStartupLeaks = yes