cb65877297
* Add --continue to continue process on launch/attach * Add small test of --continue * regenerate usage docs * minor cleanup * Use similar approach to `trace` and connect and detach using a client instance * back out previous attempt * regen usage doc * fix up continue test * fix TestContinue to properly test --continue * back out unnecessary changes * update faq
59 lines
2.5 KiB
Markdown
59 lines
2.5 KiB
Markdown
## dlv debug
|
|
|
|
Compile and begin debugging main package in current directory, or the package specified.
|
|
|
|
### Synopsis
|
|
|
|
|
|
Compiles your program with optimizations disabled, starts and attaches to it.
|
|
|
|
By default, with no arguments, Delve will compile the 'main' package in the
|
|
current directory, and begin to debug it. Alternatively you can specify a
|
|
package name and Delve will compile that package instead, and begin a new debug
|
|
session.
|
|
|
|
```
|
|
dlv debug [package]
|
|
```
|
|
|
|
### Options
|
|
|
|
```
|
|
--continue Continue the debugged process on start.
|
|
--output string Output path for the binary. (default "./__debug_bin")
|
|
```
|
|
|
|
### Options inherited from parent commands
|
|
|
|
```
|
|
--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.
|
|
--check-go-version Checks that the version of Go in use is compatible with Delve. (default true)
|
|
--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-dest string Writes logs to the specified file or file descriptor. If the argument is a number it will be interpreted as a file descriptor, otherwise as a file path. This option will also redirect the "API listening" message in headless mode.
|
|
--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
|
|
fncall Log function call protocol
|
|
minidump Log minidump loading
|
|
Defaults to "debugger" when logging is enabled with --log.
|
|
--wd string Working directory for running the program. (default ".")
|
|
```
|
|
|
|
### SEE ALSO
|
|
* [dlv](dlv.md) - Delve is a debugger for the Go programming language.
|
|
|