# eclipse-cdt-cloud/cdt-gdb-adapter architecture

> Architecture diagram of the GitHub repository eclipse-cdt-cloud/cdt-gdb-adapter, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-20). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/eclipse-cdt-cloud/cdt-gdb-adapter
- Repository: https://github.com/eclipse-cdt-cloud/cdt-gdb-adapter

## Overview

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: [`src/gdb/GDBBackend.ts`](https://github.com/eclipse-cdt-cloud/cdt-gdb-adapter/blob/main/src/gdb/GDBBackend.ts) (GDB MI backend), [`src/desktop/GDBTargetDebugSession.ts`](https://github.com/eclipse-cdt-cloud/cdt-gdb-adapter/blob/main/src/desktop/GDBTargetDebugSession.ts) (Desktop target session), [`src/desktop/GDBDebugSession.ts`](https://github.com/eclipse-cdt-cloud/cdt-gdb-adapter/blob/main/src/desktop/GDBDebugSession.ts) (Desktop session), [`src/gdb/GDBDebugSessionBase.ts`](https://github.com/eclipse-cdt-cloud/cdt-gdb-adapter/blob/main/src/gdb/GDBDebugSessionBase.ts) (DAP request handling)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_adapter["DAP entry points"]
  node_local_entry["Local adapter<br/>[debugAdapter.ts]"]
  node_target_entry["Target adapter"]
end

subgraph group_sessions["Debug sessions"]
  node_desktop_session["Desktop session<br/>[GDBDebugSession.ts]"]
  node_desktop_target_session["Desktop target session"]
  node_web_session["Web session<br/>[GDBDebugSession.ts]"]
  node_web_target_session["Web target session"]
  node_session_base["DAP request handling"]
end

subgraph group_runtime["GDB runtime"]
  node_desktop_factory["Desktop backend factory"]
  node_web_factory["Web backend factory"]
  node_desktop_manager["GDB process manager"]
  node_process_base["Process lifecycle"]
  node_backend["GDB MI backend<br/>[GDBBackend.ts]"]
  node_mi_parser["MI parser<br/>[MIParser.ts]"]
  node_mi_commands["MI command modules"]
  node_variable_manager["Variable objects<br/>[varManager.ts]"]
end

subgraph group_target["Target support"]
  node_target_server["GDB server manager"]
  node_target_factory["Server factory"]
  node_web_process["Web GDB manager"]
end

node_client(("DAP client"))
node_gdb["GDB process"]
node_server["Remote GDB server"]

node_client -->|"starts local"| node_local_entry
node_client -->|"starts target"| node_target_entry
node_local_entry -.->|"creates session"| node_desktop_session
node_target_entry -.->|"creates session"| node_desktop_target_session
node_desktop_session -->|"extends"| node_session_base
node_desktop_target_session -->|"extends"| node_desktop_session
node_web_session -->|"extends"| node_session_base
node_web_target_session -->|"extends"| node_web_session
node_desktop_session -->|"configures backend"| node_desktop_factory
node_web_factory -->|"creates backend"| node_backend
node_web_factory -->|"uses manager"| node_web_process
node_desktop_factory -.->|"creates manager"| node_desktop_manager
node_desktop_manager -->|"uses lifecycle"| node_process_base
node_process_base -->|"spawns process"| node_gdb
node_backend -->|"parses MI"| node_mi_parser
node_backend -->|"issues commands"| node_mi_commands
node_session_base -->|"handles GDB events"| node_backend
node_backend -->|"exposes manager"| node_variable_manager
node_variable_manager -->|"sends var commands"| node_mi_commands
node_desktop_target_session -->|"creates server manager"| node_target_factory
node_target_factory -.->|"creates manager"| node_target_server
node_target_server -->|"spawns server"| node_server
node_desktop_target_session -->|"configures backend"| node_backend

click node_local_entry "https://github.com/eclipse-cdt-cloud/cdt-gdb-adapter/blob/main/src/debugAdapter.ts"
click node_target_entry "https://github.com/eclipse-cdt-cloud/cdt-gdb-adapter/blob/main/src/debugTargetAdapter.ts"
click node_desktop_session "https://github.com/eclipse-cdt-cloud/cdt-gdb-adapter/blob/main/src/desktop/GDBDebugSession.ts"
click node_desktop_target_session "https://github.com/eclipse-cdt-cloud/cdt-gdb-adapter/blob/main/src/desktop/GDBTargetDebugSession.ts"
click node_web_session "https://github.com/eclipse-cdt-cloud/cdt-gdb-adapter/blob/main/src/web/GDBDebugSession.ts"
click node_web_target_session "https://github.com/eclipse-cdt-cloud/cdt-gdb-adapter/blob/main/src/web/GDBTargetDebugSession.ts"
click node_session_base "https://github.com/eclipse-cdt-cloud/cdt-gdb-adapter/blob/main/src/gdb/GDBDebugSessionBase.ts"
click node_desktop_factory "https://github.com/eclipse-cdt-cloud/cdt-gdb-adapter/blob/main/src/desktop/factories/GDBBackendFactory.ts"
click node_web_factory "https://github.com/eclipse-cdt-cloud/cdt-gdb-adapter/blob/main/src/web/factories/GDBBackendFactory.ts"
click node_desktop_manager "https://github.com/eclipse-cdt-cloud/cdt-gdb-adapter/blob/main/src/desktop/processManagers/GDBFileSystemProcessManager.ts"
click node_process_base "https://github.com/eclipse-cdt-cloud/cdt-gdb-adapter/blob/main/src/desktop/processManagers/GDBFileSystemProcessManagerBase.ts"
click node_backend "https://github.com/eclipse-cdt-cloud/cdt-gdb-adapter/blob/main/src/gdb/GDBBackend.ts"
click node_mi_parser "https://github.com/eclipse-cdt-cloud/cdt-gdb-adapter/blob/main/src/MIParser.ts"
click node_mi_commands "https://github.com/eclipse-cdt-cloud/cdt-gdb-adapter/tree/main/src/mi"
click node_variable_manager "https://github.com/eclipse-cdt-cloud/cdt-gdb-adapter/blob/main/src/varManager.ts"
click node_target_server "https://github.com/eclipse-cdt-cloud/cdt-gdb-adapter/blob/main/src/desktop/processManagers/GDBServerFileSystemProcessManager.ts"
click node_target_factory "https://github.com/eclipse-cdt-cloud/cdt-gdb-adapter/blob/main/src/desktop/factories/GDBServerFactory.ts"
click node_web_process "https://github.com/eclipse-cdt-cloud/cdt-gdb-adapter/blob/main/src/web/processManagers/GDBWebProcessManager.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_local_entry,node_target_entry,node_client toneBlue
class node_desktop_session,node_desktop_target_session,node_web_session,node_web_target_session,node_session_base toneAmber
class node_desktop_factory,node_web_factory,node_desktop_manager,node_process_base,node_backend,node_mi_parser,node_mi_commands,node_variable_manager,node_server toneMint
class node_target_server,node_target_factory,node_web_process toneRose
class node_gdb toneIndigo
```

## Components

### DAP entry points

- [Local adapter](https://github.com/eclipse-cdt-cloud/cdt-gdb-adapter/blob/main/src/debugAdapter.ts): `src/debugAdapter.ts`
- [Target adapter](https://github.com/eclipse-cdt-cloud/cdt-gdb-adapter/blob/main/src/debugTargetAdapter.ts): `src/debugTargetAdapter.ts`

### Debug sessions

- [Desktop session](https://github.com/eclipse-cdt-cloud/cdt-gdb-adapter/blob/main/src/desktop/GDBDebugSession.ts): `src/desktop/GDBDebugSession.ts`
- [Desktop target session](https://github.com/eclipse-cdt-cloud/cdt-gdb-adapter/blob/main/src/desktop/GDBTargetDebugSession.ts): `src/desktop/GDBTargetDebugSession.ts`
- [Web session](https://github.com/eclipse-cdt-cloud/cdt-gdb-adapter/blob/main/src/web/GDBDebugSession.ts): `src/web/GDBDebugSession.ts`
- [Web target session](https://github.com/eclipse-cdt-cloud/cdt-gdb-adapter/blob/main/src/web/GDBTargetDebugSession.ts): `src/web/GDBTargetDebugSession.ts`
- [DAP request handling](https://github.com/eclipse-cdt-cloud/cdt-gdb-adapter/blob/main/src/gdb/GDBDebugSessionBase.ts): `src/gdb/GDBDebugSessionBase.ts`

### GDB runtime

- [Desktop backend factory](https://github.com/eclipse-cdt-cloud/cdt-gdb-adapter/blob/main/src/desktop/factories/GDBBackendFactory.ts): `src/desktop/factories/GDBBackendFactory.ts`
- [Web backend factory](https://github.com/eclipse-cdt-cloud/cdt-gdb-adapter/blob/main/src/web/factories/GDBBackendFactory.ts): `src/web/factories/GDBBackendFactory.ts`
- [GDB process manager](https://github.com/eclipse-cdt-cloud/cdt-gdb-adapter/blob/main/src/desktop/processManagers/GDBFileSystemProcessManager.ts): `src/desktop/processManagers/GDBFileSystemProcessManager.ts`
- [Process lifecycle](https://github.com/eclipse-cdt-cloud/cdt-gdb-adapter/blob/main/src/desktop/processManagers/GDBFileSystemProcessManagerBase.ts): `src/desktop/processManagers/GDBFileSystemProcessManagerBase.ts`
- [GDB MI backend](https://github.com/eclipse-cdt-cloud/cdt-gdb-adapter/blob/main/src/gdb/GDBBackend.ts): `src/gdb/GDBBackend.ts`
- [MI parser](https://github.com/eclipse-cdt-cloud/cdt-gdb-adapter/blob/main/src/MIParser.ts): `src/MIParser.ts`
- [MI command modules](https://github.com/eclipse-cdt-cloud/cdt-gdb-adapter/tree/main/src/mi): `src/mi`
- [Variable objects](https://github.com/eclipse-cdt-cloud/cdt-gdb-adapter/blob/main/src/varManager.ts): `src/varManager.ts`

### Target support

- [GDB server manager](https://github.com/eclipse-cdt-cloud/cdt-gdb-adapter/blob/main/src/desktop/processManagers/GDBServerFileSystemProcessManager.ts): `src/desktop/processManagers/GDBServerFileSystemProcessManager.ts`
- [Server factory](https://github.com/eclipse-cdt-cloud/cdt-gdb-adapter/blob/main/src/desktop/factories/GDBServerFactory.ts): `src/desktop/factories/GDBServerFactory.ts`
- [Web GDB manager](https://github.com/eclipse-cdt-cloud/cdt-gdb-adapter/blob/main/src/web/processManagers/GDBWebProcessManager.ts): `src/web/processManagers/GDBWebProcessManager.ts`

### Other components

- **DAP client**
- **GDB process**
- **Remote GDB server**

## Connections

- 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 (evidence: `src/desktop/GDBDebugSession.ts`)
- Desktop target session → Desktop session: extends (evidence: `src/desktop/GDBTargetDebugSession.ts`)
- Web session → DAP request handling: extends (evidence: `src/web/GDBDebugSession.ts`)
- Web target session → Web session: extends (evidence: `src/web/GDBTargetDebugSession.ts`)
- Desktop session → Desktop backend factory: configures backend (evidence: `src/desktop/GDBDebugSession.ts`)
- Web backend factory → GDB MI backend: creates backend (evidence: `src/web/factories/GDBBackendFactory.ts`)
- Web backend factory → Web GDB manager: uses manager (evidence: `src/web/factories/GDBBackendFactory.ts`)
- Desktop backend factory → GDB process manager: creates manager
- GDB process manager → Process lifecycle: uses lifecycle (evidence: `src/desktop/processManagers/GDBFileSystemProcessManager.ts`)
- Process lifecycle → GDB process: spawns process (evidence: `src/desktop/processManagers/GDBFileSystemProcessManagerBase.ts`)
- GDB MI backend → MI parser: parses MI (evidence: `src/gdb/GDBBackend.ts`)
- GDB MI backend → MI command modules: issues commands (evidence: `src/gdb/GDBBackend.ts`)
- DAP request handling → GDB MI backend: handles GDB events (evidence: `src/gdb/GDBDebugSessionBase.ts`)
- GDB MI backend → Variable objects: exposes manager (evidence: `src/gdb/GDBBackend.ts`)
- Variable objects → MI command modules: sends var commands (evidence: `src/varManager.ts`)
- Desktop target session → Server factory: creates server manager (evidence: `src/desktop/GDBTargetDebugSession.ts`)
- Server factory → GDB server manager: creates manager
- GDB server manager → Remote GDB server: spawns server (evidence: `src/desktop/processManagers/GDBServerFileSystemProcessManager.ts`)
- Desktop target session → GDB MI backend: configures backend (evidence: `src/desktop/GDBTargetDebugSession.ts`)
