454491ce86
We occasionally receive bug reports from users of VSCode-go and GoLand. GoLand has its own way of capturing the packet exchange between itself and delve but VSCode-go (supposedly) doesn't. So far this hasn't been a problem since all bug reports were obvious bugs on the plugin or easy to reproduce without VSCode-go, but it might be helpful in the future to have a way to log the packet exchange between dlv and a frontend. This commit adds a --log-output option to enable logging of all rpc messages and changes service/rpccommon accordingly.
57 lines
2.6 KiB
Markdown
57 lines
2.6 KiB
Markdown
## dlv
|
|
|
|
Delve is a debugger for the Go programming language.
|
|
|
|
### Synopsis
|
|
|
|
|
|
Delve is a source level debugger for Go programs.
|
|
|
|
Delve enables you to interact with your program by controlling the execution of the process,
|
|
evaluating variables, and providing information of thread / goroutine state, CPU register state and more.
|
|
|
|
The goal of this tool is to provide a simple yet powerful interface for debugging Go programs.
|
|
|
|
Pass flags to the program you are debugging using `--`, for example:
|
|
|
|
`dlv exec ./hello -- server --config conf/config.toml`
|
|
|
|
### Options
|
|
|
|
```
|
|
--accept-multiclient Allows a headless server to accept multiple client connections. Note that the server API is not reentrant and clients will have to coordinate.
|
|
--api-version int Selects API version when headless. (default 1)
|
|
--backend string Backend selection:
|
|
default Uses lldb on macOS, native everywhere else.
|
|
native Native backend.
|
|
lldb Uses lldb-server or debugserver.
|
|
rr Uses mozilla rr (https://github.com/mozilla/rr).
|
|
(default "default")
|
|
--build-flags string Build flags, to be passed to the compiler.
|
|
--headless Run debug server only, in headless mode.
|
|
--init string Init file, executed by the terminal client.
|
|
-l, --listen string Debugging server listen address. (default "localhost:0")
|
|
--log Enable debugging server logging.
|
|
--log-output string Comma separated list of components that should produce debug output, possible values:
|
|
debugger Log debugger commands
|
|
gdbwire Log connection to gdbserial backend
|
|
lldbout Copy output from debugserver/lldb to standard output
|
|
debuglineerr Log recoverable errors reading .debug_line
|
|
rpc Log all RPC messages
|
|
Defaults to "debugger" when logging is enabled with --log.
|
|
--wd string Working directory for running the program. (default ".")
|
|
```
|
|
|
|
### SEE ALSO
|
|
* [dlv attach](dlv_attach.md) - Attach to running process and begin debugging.
|
|
* [dlv connect](dlv_connect.md) - Connect to a headless debug server.
|
|
* [dlv core](dlv_core.md) - Examine a core dump.
|
|
* [dlv debug](dlv_debug.md) - Compile and begin debugging main package in current directory, or the package specified.
|
|
* [dlv exec](dlv_exec.md) - Execute a precompiled binary, and begin a debug session.
|
|
* [dlv replay](dlv_replay.md) - Replays a rr trace.
|
|
* [dlv run](dlv_run.md) - Deprecated command. Use 'debug' instead.
|
|
* [dlv test](dlv_test.md) - Compile test binary and begin debugging program.
|
|
* [dlv trace](dlv_trace.md) - Compile and begin tracing program.
|
|
* [dlv version](dlv_version.md) - Prints version.
|
|
|