# go-delve/delve architecture

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

- Interactive diagram: https://gitdiagram.com/go-delve/delve
- Repository: https://github.com/go-delve/delve

## Overview

Delve is a Go debugger: users control a running or attached Go process through the CLI or a DAP/RPC client, while the debugger manages execution and exposes source-level state. Its runtime also resolves locations and executable metadata through DWARF and symbol information, and supports architecture- and OS-specific process backends. The graph preserves the documented CLI and frontend workflows plus core analysis layers. Several subsystem links are omitted where the excerpts establish imports or capabilities but not actual calls; dashed links mark unverified backend relationships.

Main entry points: [`service/debugger/debugger.go`](https://github.com/go-delve/delve/blob/master/service/debugger/debugger.go) (Debugger engine), [`pkg/proc/bininfo.go`](https://github.com/go-delve/delve/blob/master/pkg/proc/bininfo.go) (Binary metadata), [`service/dap/server.go`](https://github.com/go-delve/delve/blob/master/service/dap/server.go) (DAP session), [`service/rpc2/server.go`](https://github.com/go-delve/delve/blob/master/service/rpc2/server.go) (RPC methods)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["User interfaces"]
  node_cli["CLI commands<br/>[command.go]"]
end

subgraph group_service["Service protocols"]
  node_dap["DAP session<br/>[server.go]"]
  node_rpccommon["RPC server<br/>[server.go]"]
  node_rpc2server["RPC methods<br/>[server.go]"]
  node_rpcclient["RPC client<br/>[client.go]"]
  node_clientapi["Client interface<br/>[client.go]"]
end

subgraph group_debug["Debug control"]
  node_debugger["Debugger engine<br/>[debugger.go]"]
  node_proc["Process model<br/>[target.go]"]
  node_native["OS process control<br/>[proc.go]"]
  node_gdbserial["GDB remote<br/>[gdbserver.go]"]
end

subgraph group_analysis["Program analysis"]
  node_locations["Location resolver<br/>[locations.go]"]
  node_bininfo["Binary metadata<br/>[bininfo.go]"]
  node_dwarfline["DWARF line parser<br/>[line_parser.go]"]
  node_dwarfframe["DWARF frame parser<br/>[parser.go]"]
  node_dwarfreader["DWARF reader<br/>[reader.go]"]
end

node_user(("Debugger user"))
node_goexe["Go program"]

node_user -.->|"enters commands"| node_cli
node_user -.->|"sends requests"| node_dap
node_cli -->|"controls debugger"| node_clientapi
node_rpcclient -->|"sends JSON-RPC"| node_rpc2server
node_rpcclient -->|"implements"| node_clientapi
node_rpccommon -->|"dispatches methods"| node_rpc2server
node_rpccommon -->|"routes DAP"| node_dap
node_dap -->|"controls"| node_debugger
node_rpc2server -->|"invokes operations"| node_debugger
node_debugger -->|"manages targets"| node_proc
node_debugger -.->|"uses process backend"| node_native
node_debugger -.->|"supports remote backend"| node_gdbserial
node_debugger -.->|"resolves locations"| node_locations
node_proc -.->|"uses executable metadata"| node_bininfo
node_bininfo -->|"parses line data"| node_dwarfline
node_bininfo -->|"parses frame data"| node_dwarfframe
node_bininfo -->|"reads debug info"| node_dwarfreader
node_native -.->|"controls process"| node_goexe

click node_cli "https://github.com/go-delve/delve/blob/master/pkg/terminal/command.go"
click node_dap "https://github.com/go-delve/delve/blob/master/service/dap/server.go"
click node_rpccommon "https://github.com/go-delve/delve/blob/master/service/rpccommon/server.go"
click node_rpc2server "https://github.com/go-delve/delve/blob/master/service/rpc2/server.go"
click node_rpcclient "https://github.com/go-delve/delve/blob/master/service/rpc2/client.go"
click node_clientapi "https://github.com/go-delve/delve/blob/master/service/client.go"
click node_debugger "https://github.com/go-delve/delve/blob/master/service/debugger/debugger.go"
click node_proc "https://github.com/go-delve/delve/blob/master/pkg/proc/target.go"
click node_native "https://github.com/go-delve/delve/blob/master/pkg/proc/native/proc.go"
click node_gdbserial "https://github.com/go-delve/delve/blob/master/pkg/proc/gdbserial/gdbserver.go"
click node_locations "https://github.com/go-delve/delve/blob/master/pkg/locspec/locations.go"
click node_bininfo "https://github.com/go-delve/delve/blob/master/pkg/proc/bininfo.go"
click node_dwarfline "https://github.com/go-delve/delve/blob/master/pkg/dwarf/line/line_parser.go"
click node_dwarfframe "https://github.com/go-delve/delve/blob/master/pkg/dwarf/frame/parser.go"
click node_dwarfreader "https://github.com/go-delve/delve/blob/master/pkg/dwarf/reader/reader.go"

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_cli,node_user toneBlue
class node_dap,node_rpccommon,node_rpc2server,node_rpcclient,node_clientapi toneAmber
class node_debugger,node_proc,node_native,node_gdbserial toneMint
class node_locations,node_bininfo,node_dwarfline,node_dwarfframe,node_dwarfreader toneRose
class node_goexe toneIndigo
```

## Components

### User interfaces

- [CLI commands](https://github.com/go-delve/delve/blob/master/pkg/terminal/command.go): `pkg/terminal/command.go`

### Service protocols

- [DAP session](https://github.com/go-delve/delve/blob/master/service/dap/server.go): `service/dap/server.go`
- [RPC server](https://github.com/go-delve/delve/blob/master/service/rpccommon/server.go): `service/rpccommon/server.go`
- [RPC methods](https://github.com/go-delve/delve/blob/master/service/rpc2/server.go): `service/rpc2/server.go`
- [RPC client](https://github.com/go-delve/delve/blob/master/service/rpc2/client.go): `service/rpc2/client.go`
- [Client interface](https://github.com/go-delve/delve/blob/master/service/client.go): `service/client.go`

### Debug control

- [Debugger engine](https://github.com/go-delve/delve/blob/master/service/debugger/debugger.go): `service/debugger/debugger.go`
- [Process model](https://github.com/go-delve/delve/blob/master/pkg/proc/target.go): `pkg/proc/target.go`
- [OS process control](https://github.com/go-delve/delve/blob/master/pkg/proc/native/proc.go): `pkg/proc/native/proc.go`
- [GDB remote](https://github.com/go-delve/delve/blob/master/pkg/proc/gdbserial/gdbserver.go): `pkg/proc/gdbserial/gdbserver.go`

### Program analysis

- [Location resolver](https://github.com/go-delve/delve/blob/master/pkg/locspec/locations.go): `pkg/locspec/locations.go`
- [Binary metadata](https://github.com/go-delve/delve/blob/master/pkg/proc/bininfo.go): `pkg/proc/bininfo.go`
- [DWARF line parser](https://github.com/go-delve/delve/blob/master/pkg/dwarf/line/line_parser.go): `pkg/dwarf/line/line_parser.go`
- [DWARF frame parser](https://github.com/go-delve/delve/blob/master/pkg/dwarf/frame/parser.go): `pkg/dwarf/frame/parser.go`
- [DWARF reader](https://github.com/go-delve/delve/blob/master/pkg/dwarf/reader/reader.go): `pkg/dwarf/reader/reader.go`

### Other components

- **Debugger user**
- **Go program**

## Connections

- Debugger user → CLI commands: enters commands
- Debugger user → DAP session: sends requests
- CLI commands → Client interface: controls debugger (evidence: `pkg/terminal/command.go`)
- RPC client → RPC methods: sends JSON-RPC (evidence: `service/rpc2/client.go`)
- RPC client → Client interface: implements (evidence: `service/rpc2/client.go`)
- RPC server → RPC methods: dispatches methods (evidence: `service/rpccommon/server.go`)
- RPC server → DAP session: routes DAP (evidence: `service/rpccommon/server.go`)
- DAP session → Debugger engine: controls (evidence: `service/dap/server.go`)
- RPC methods → Debugger engine: invokes operations (evidence: `service/rpc2/server.go`)
- Debugger engine → Process model: manages targets (evidence: `service/debugger/debugger.go`)
- Debugger engine → OS process control: uses process backend
- Debugger engine → GDB remote: supports remote backend
- Debugger engine → Location resolver: resolves locations
- Process model → Binary metadata: uses executable metadata
- Binary metadata → DWARF line parser: parses line data (evidence: `pkg/proc/bininfo.go`)
- Binary metadata → DWARF frame parser: parses frame data (evidence: `pkg/proc/bininfo.go`)
- Binary metadata → DWARF reader: reads debug info (evidence: `pkg/proc/bininfo.go`)
- OS process control → Go program: controls process
