Guitarix
documentation/debugbuild.md
Go to the documentation of this file.
1 <!-- -*- mode: markdown; mode: flyspell; ispell-local-dictionary: "american" -*- -->
2 \page debugbuild Guitarix debug build
3 
4 Use "./waf configure --debug" to enable debugging code. If you want to
5 use gdb you might want to set --cxxflags-debug='-O1 -g'.
6 
7 Some environment variables are recognized in the debug build:
8 
9 ### GUITARIX_MEASURE (Measurement of DSP processing times)
10 
11 Time measurement is switched on by defining the environment variable
12 GUITARIX_MEASURE. When setting its value to 1 results are more
13 verbose. Results are printed each second on stdout. On intel
14 architecture it also prints warnings when denormals are encountered
15 during processing.
16 
17 For better controlled measurements you can disable frequency scaling
18 and set cpu affinity:
19 
20 $ sudo cpufreq-set -d 800MHz -u 800MHz # or whatever your cpu supports
21 $ GUITARIX_MEASURE=1 taskset -c 1 guitarix
22 
23 ### GUITARIX_MODULE_DEBUG (list of effect plugins)
24 
25 The full list of effect plugins is output, then the list of active
26 plugins after each change.
27 
28 ### GUITARIX_TRACE (parameter changes sent to server)
29 
30 Only when starting Guitarix as user interface client: Output all
31 parameter changes sent to the server (changes marked with (blocked)
32 are originated by the server and not reflected back). When set to a
33 value (other than empty string), print only changes for that parameter
34 id.