File: README.logging

package info (click to toggle)
seergdb 2.5%2Bgit20250220%2Bds-1
  • links: PTS, VCS
  • area: main
  • in suites: trixie
  • size: 8,064 kB
  • sloc: cpp: 27,553; ansic: 1,268; makefile: 666; python: 665; asm: 244; ada: 102; fortran: 12
file content (41 lines) | stat: -rw-r--r-- 1,516 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
Seer uses Qt's logging in a few places. This is for the purpose of debugging issues
for a released version.

Qt's logging is described in:

    https://doc.qt.io/qt-5/qloggingcategory.html

Seer has these logging categories:

    seer.seergdbwidget.debug        # The object that communicates with the gdb process
    seer.gdbmonitor.debug           # The object that monitors output from the gdb process
    ^  ^ ^        ^ ^___^___________The logging channel. Can be debug, warning, critical, info.
    |  | |________|_________________The logging category. It should follow the Seer class name, in lowercase.
    |__|____________________________Always the seer name.

Not all Seer classes have logging programmed. The above list will be updated as needed.

There are a few ways to enable logging. The easiest is by the environment variable.
Turn on logging like this:

    % export QT_LOGGING_RULES="default.debug=true"
    % export QT_LOGGING_RULES="default.debug=false;seer.gdbwidget.debug=true"
    % export QT_LOGGING_RULES="default.debug=false;seer.gdbmonitor.debug=true"
    % export QT_LOGGING_RULES="default.debug=true;seer.gdbwidget.debug=true"

To turn on simple logging of qDebug(), et al, set this:

    % export QT_LOGGING_RULES="default.debug=true"

Then start seer. There should be lots of debug output.



If qDebug() output is missing filename and lineno information. Like:

    [16:57:16][unknown:0][default] Some text...

Then build with debug turned on.

    cmake -DCMAKE_BUILD_TYPE=Debug ..