Difference between revisions of "Coder Tools"
(Add valgrind and callgrind details) |
m (Cosmetics) |
||
| Line 1: | Line 1: | ||
| + | [[Category:Development]] | ||
| + | |||
Sometimes somebody finds a tool, which is better than standard tools. Here we share our knowledge. | Sometimes somebody finds a tool, which is better than standard tools. Here we share our knowledge. | ||
| Line 22: | Line 24: | ||
On the other hand valgrind has been around for a very long time and people may prefer it over the "newer" siblings. So here are a few notes on how to use it. After building gnucash, run | On the other hand valgrind has been around for a very long time and people may prefer it over the "newer" siblings. So here are a few notes on how to use it. After building gnucash, run | ||
| − | <syntaxhighlight lang="sh" | + | <syntaxhighlight lang="sh"> |
$ ${prefix}/bin/gnucash-valgrind | $ ${prefix}/bin/gnucash-valgrind | ||
</syntaxhighlight> | </syntaxhighlight> | ||
| Line 53: | Line 55: | ||
Add the following to the start of the file: | Add the following to the start of the file: | ||
| − | <syntaxhighlight lang="c" | + | <syntaxhighlight lang="c"> |
#include <valgrind/callgrind.h> | #include <valgrind/callgrind.h> | ||
</syntaxhighlight> | </syntaxhighlight> | ||
| Line 60: | Line 62: | ||
Add the following to the start of the calling function: | Add the following to the start of the calling function: | ||
| − | <syntaxhighlight lang="c" | + | <syntaxhighlight lang="c"> |
static GTimeVal start, end; | static GTimeVal start, end; | ||
</syntaxhighlight> | </syntaxhighlight> | ||
| Line 66: | Line 68: | ||
Add the following just before the function of interest: | Add the following just before the function of interest: | ||
| − | <syntaxhighlight lang="c" | + | <syntaxhighlight lang="c"> |
g_print("Start timing.\n"); | g_print("Start timing.\n"); | ||
g_get_current_time(&start); | g_get_current_time(&start); | ||
| Line 75: | Line 77: | ||
Add the following just after the function of interest: | Add the following just after the function of interest: | ||
| − | <syntaxhighlight lang="c" | + | <syntaxhighlight lang="c"> |
CALLGRIND_TOGGLE_COLLECT(); | CALLGRIND_TOGGLE_COLLECT(); | ||
CALLGRIND_STOP_INSTRUMENTATION(); | CALLGRIND_STOP_INSTRUMENTATION(); | ||
| Line 95: | Line 97: | ||
valgrind you will need to remove the trailing parentheses and | valgrind you will need to remove the trailing parentheses and | ||
semicolon. | semicolon. | ||
| − | |||
| − | |||
| − | |||
Revision as of 19:31, 29 May 2024
Sometimes somebody finds a tool, which is better than standard tools. Here we share our knowledge.
Memory Leaks
- heaptrack v1-1-0-release from [1]. Most linux distributions also ship it as a package.
Profiling
For C exist sysprof, hotspot, heaptrack (memory profiler), Valgrind,... Plenty of profiling tools. I have done some profiling with sysprof and heaptrack (never used valgrind). Both have interactive user interfaces to drill down on profiling data. I currently prefer heaptrack as it doesn't need special privileges. Last time I used sysprof (which has been a while) it needed admin privileges to run.
Using Valgrind with GnuCash
(This information was extracted from the Hacking file in the GnuCash source directory)
Note: tools like sysprof and hotspot mentioned above can be used directly without any source or build modifications. That makes them relatively easy to get started with.
On the other hand valgrind has been around for a very long time and people may prefer it over the "newer" siblings. So here are a few notes on how to use it. After building gnucash, run
$ ${prefix}/bin/gnucash-valgrind
However, I did not find valgrind to be useful. It reported a bunch of guile bugs, some g_hash_table bugs, and then the program exited prematurely for no apparent reason. :-(
For the moment, gnucash-valgrind uses the suppressions in src/debug/valgrind/valgrind-*.supp
For valgrind-gnucash.supp, this comment was made (but is perhaps outdated by now ?): This file needs to be cleaned up in two ways:
- There are a bunch of duplicate suppressions in the file - the suppressions in place were auto-generated by valgrind itself [--gen-suppressions=yes], and it makes no effort to output the suppression only once.
- There are a bunch of suppressions which need to not be suppressions, but instead just not be generated by valgrind.
Using Callgrind with GnuCash
(As with valgrind, this snippet was extraced from the Hacking file in the GnuCash source directory.)
In order to debug with callgrind, you need to add a couple of code fragments around the section of code you are profiling. This is easiest if you can find the function that invokes the routine(s) you want to profile, add the following code around the function call of interest.
Add the following to the start of the file:
#include <valgrind/callgrind.h>
Add the following to the start of the calling function:
static GTimeVal start, end;
Add the following just before the function of interest:
g_print("Start timing.\n");
g_get_current_time(&start);
CALLGRIND_START_INSTRUMENTATION();
CALLGRIND_TOGGLE_COLLECT();
Add the following just after the function of interest:
CALLGRIND_TOGGLE_COLLECT();
CALLGRIND_STOP_INSTRUMENTATION();
g_get_current_time(&end);
if (start.tv_usec > end.tv_usec) {
end.tv_usec += 1000000;
end.tv_sec -= 1;
}
g_print("Callgrind enabled for %d.%6d seconds.\n",
(int)(end.tv_sec - start.tv_sec),
(int)(end.tv_usec - start.tv_usec));
You will need to recompile, and then run the 'gnucash-valgrind' wrapper script instead of the normal 'gnucash' script.
Note Version 3.2 of valgrind has changed the above macros to no longer take an argument. In order to compile with this version of valgrind you will need to remove the trailing parentheses and semicolon.
