summaryrefslogtreecommitdiff
path: root/src/plugins/debugger/README
blob: a3e17e08403393be9f1e0175b6feae26f2f52a06 (plain)
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
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73

Architectural overview
----------------------

DebuggerPlugin is the main interface between the Qt Creator "Core" and the
DebuggerManager who is responsible for "doing the work".

The DebuggerManager creates all DebuggerEngines, and has zero or one
"current" Engine. Engines represent an interface to a "native" debugger.
Right now there are engines for gdb (used for C++ on Linux, Mac, Windows/MinGW,
Maemo and Symbian), for cdb (used for C++ on Windows/MSVC) and "script" (used
for JavaScript on all platforms).

  The GdbEngine has different "Adapters" to cope with the variety of environments
  it has to cope with. All gdb Adapters inherit from AbstractGdbAdapters.

    PlainGdbAdapter handles debugging of locally started GUI processes.
    It is physically split into parts
    relevant only when Python is available, parts relevant only when Python is
    not available and "mixed" code.

    TermGdbAdapter is used to debug locally started processes that need a
    console.

    AttachGdbAdapter is used to debug local processes started outside Creator.

    CoreGdbAdapter is used to debug core files generated from crashes.

    RemoteGdbAdapter is used to talk to gdbserver running on Linux.

    TrkGdbAdapter is used to talk to Symbian devices using the gdb protocol and
    the gdb serial protocol between gdb and the Adapter and the TRK protocol
    between the adapter and AppTRK running on the device.

  Gdb comes in main two flavours: with or without Python. The Python version
  is preferred, but it is not available on Mac and on older versions of Linux.
  On Windows, Symbian and Maemo we only support the Python version.

  The non-Python versions use the compiled version of the debugging helpers,
  that needs to be enabled in the Qt4 Versions dialog, the Python version use
  the script version that does not need any special setup.

  The CdbEngine is functionality-wise similar to the Non-Python GdbEngine on
  Linux, most notably it uses the same setup for the debugging helper library
  (compiled C++ code).




Per platform the situation for C++ debugging looks like:
[Helper loading strategy: /i - injected, /p - preload, /- not available]

          Symbian    Maemo       Linux          Mac            Windows
                                                          MinGW       MSVC

Engine:     gdb      gdb          gdb           gdb        gdb        cdb

Python:     yes      yes       yes     no       no         no        (not/appl)

Adapters:   trk     remote    term   term/i     term/i     term       term/i
                              plain  plain/p    plain/i    plain      plain/i
                              attach attach/i   attach/i   attach     attach/i
                              remote attach/-   remote/-   remote

Minimum
supported  FSF       FSF      FSF     FSF       Apple      FSF         -
version:   7.1       7.1      7.1     6.8       1344       7.2
                  (no python)

Version    FSF       FSF          FSF           (XCode)    FSF         -
in SDK:    7.2       7.1          7.2                      7.2
                  (no python)