Oops
[asterisk/asterisk.git] / doc / valgrind.txt
1 If you're having certain types of crashes, such as those associated with
2 memory corruption, a bug marshal may ask you to run Asterisk under valgrind.
3 You should follow these steps, to give the bug marshal the maximum amount
4 of information about the crash.
5
6 1.  Run 'make menuselect' and in the Compiler Options, enable MALLOC_DEBUG
7         and DONT_OPTIMIZE.  A bug marshal may also ask you to enable additional
8         compiler flags, such as DEBUG_THREADS, depending upon the nature of the
9         issue.
10
11 2.  Rebuild and install Asterisk.
12
13 3.  Run Asterisk as follows:
14         valgrind --log-file-exactly=valgrind.txt asterisk -vvvvcg 2>malloc_debug.txt
15
16 4.  Reproduce the issue.  Following the manifestation of the issue (or when
17         the process crashes), upload the two files, valgrind.txt and
18         malloc_debug.txt to the issue tracker.
19