How eclipse-cdt-cloud/cdt-gdb-adapter works
CDT GDB Debug Adapter implements the Debug Adapter Protocol (DAP) over GDB’s Machine Interface (MI). The principal workflow is a client launching or attaching through a local or target-debugging entry point; a session configures process managers and backends, then translates DAP operations and GDB activity. Target debugging adds server/remote-target handling. The graph includes the documented local and remote entry points and the sampled MI/backend layers; web process-manager implementations are present but the sampled web manager explicitly reports its operations as unimplemented. Relationships are limited to README statements and source-index references or excerpts.
Main entry points: GDBBackend.ts GDB MI backend · GDBTargetDebugSession.ts Desktop target session · GDBDebugSession.ts Desktop session · GDBDebugSessionBase.ts DAP request handling
Components 21
DAP entry points
- Local adapter
src/debugAdapter.ts - Target adapter
src/debugTargetAdapter.ts
Debug sessions
- Desktop session
src/desktop/GDBDebugSession.ts - Desktop target session
src/desktop/GDBTargetDebugSession.ts - Web session
src/web/GDBDebugSession.ts - Web target session
src/web/GDBTargetDebugSession.ts - DAP request handling
src/gdb/GDBDebugSessionBase.ts
GDB runtime
- Desktop backend factory
src/desktop/factories/GDBBackendFactory.ts - Web backend factory
src/web/factories/GDBBackendFactory.ts - GDB process manager
src/desktop/processManagers/GDBFileSystemProcessManager.ts - Process lifecycle
src/desktop/processManagers/GDBFileSystemProcessManagerBase.ts - GDB MI backend
src/gdb/GDBBackend.ts - MI parser
src/MIParser.ts - MI command modules
src/mi - Variable objects
src/varManager.ts
Target support
- GDB server manager
src/desktop/processManagers/GDBServerFileSystemProcessManager.ts - Server factory
src/desktop/factories/GDBServerFactory.ts - Web GDB manager
src/web/processManagers/GDBWebProcessManager.ts
Other components
- DAP client
- GDB process
- Remote GDB server
Connections 23
- DAP client → Local adapter: starts local
- DAP client → Target adapter: starts target
- Local adapter → Desktop session: creates session
- Target adapter → Desktop target session: creates session
- Desktop session → DAP request handling: extends
src/desktop/GDBDebugSession.ts - Desktop target session → Desktop session: extends
src/desktop/GDBTargetDebugSession.ts - Web session → DAP request handling: extends
src/web/GDBDebugSession.ts - Web target session → Web session: extends
src/web/GDBTargetDebugSession.ts - Desktop session → Desktop backend factory: configures backend
src/desktop/GDBDebugSession.ts - Web backend factory → GDB MI backend: creates backend
src/web/factories/GDBBackendFactory.ts - Web backend factory → Web GDB manager: uses manager
src/web/factories/GDBBackendFactory.ts - Desktop backend factory → GDB process manager: creates manager
- GDB process manager → Process lifecycle: uses lifecycle
src/desktop/processManagers/GDBFileSystemProcessManager.ts - Process lifecycle → GDB process: spawns process
src/desktop/processManagers/GDBFileSystemProcessManagerBase.ts - GDB MI backend → MI parser: parses MI
src/gdb/GDBBackend.ts - GDB MI backend → MI command modules: issues commands
src/gdb/GDBBackend.ts - DAP request handling → GDB MI backend: handles GDB events
src/gdb/GDBDebugSessionBase.ts - GDB MI backend → Variable objects: exposes manager
src/gdb/GDBBackend.ts - Variable objects → MI command modules: sends var commands
src/varManager.ts - Desktop target session → Server factory: creates server manager
src/desktop/GDBTargetDebugSession.ts - Server factory → GDB server manager: creates manager
- GDB server manager → Remote GDB server: spawns server
src/desktop/processManagers/GDBServerFileSystemProcessManager.ts - Desktop target session → GDB MI backend: configures backend
src/desktop/GDBTargetDebugSession.ts