How go-delve/delve works
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: debugger.go Debugger engine · bininfo.go Binary metadata · dap/server.go DAP session · rpc2/server.go RPC methods
Components 17
User interfaces
- CLI commands
pkg/terminal/command.go
Service protocols
- DAP session
service/dap/server.go - RPC server
service/rpccommon/server.go - RPC methods
service/rpc2/server.go - RPC client
service/rpc2/client.go - Client interface
service/client.go
Debug control
- Debugger engine
service/debugger/debugger.go - Process model
pkg/proc/target.go - OS process control
pkg/proc/native/proc.go - GDB remote
pkg/proc/gdbserial/gdbserver.go
Program analysis
- Location resolver
pkg/locspec/locations.go - Binary metadata
pkg/proc/bininfo.go - DWARF line parser
pkg/dwarf/line/line_parser.go - DWARF frame parser
pkg/dwarf/frame/parser.go - DWARF reader
pkg/dwarf/reader/reader.go
Other components
- Debugger user
- Go program
Connections 18
- Debugger user → CLI commands: enters commands
- Debugger user → DAP session: sends requests
- CLI commands → Client interface: controls debugger
pkg/terminal/command.go - RPC client → RPC methods: sends JSON-RPC
service/rpc2/client.go - RPC client → Client interface: implements
service/rpc2/client.go - RPC server → RPC methods: dispatches methods
service/rpccommon/server.go - RPC server → DAP session: routes DAP
service/rpccommon/server.go - DAP session → Debugger engine: controls
service/dap/server.go - RPC methods → Debugger engine: invokes operations
service/rpc2/server.go - Debugger engine → Process model: manages targets
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
pkg/proc/bininfo.go - Binary metadata → DWARF frame parser: parses frame data
pkg/proc/bininfo.go - Binary metadata → DWARF reader: reads debug info
pkg/proc/bininfo.go - OS process control → Go program: controls process