caf6df0eb9
Due to some very old mistakes too many of Delve's flags are declared as persistent on cobra's root command. For example the headless flag is a global flag but does not apply to connect, dap or trace; the backend flag does not apply to replay, core and dap; etc. Almost all global flags should have been declared as local flags on individual subcommands. Unfortunately we can not change this without breaking backwards compatibility, for example: dlv --headless debug would not parse if headless was a flag of debug instead of a global flag. Instead we alter usage function and the markdown generation script to strategically hide the flags that don't apply. Fixes #2361
44 lines
1.9 KiB
Markdown
44 lines
1.9 KiB
Markdown
## dlv replay
|
|
|
|
Replays a rr trace.
|
|
|
|
### Synopsis
|
|
|
|
Replays a rr trace.
|
|
|
|
The replay command will open a trace generated by mozilla rr. Mozilla rr must be installed:
|
|
https://github.com/mozilla/rr
|
|
|
|
|
|
```
|
|
dlv replay [trace directory] [flags]
|
|
```
|
|
|
|
### Options
|
|
|
|
```
|
|
-h, --help help for replay
|
|
-p, --onprocess int Pass onprocess pid to rr.
|
|
```
|
|
|
|
### Options inherited from parent commands
|
|
|
|
```
|
|
--accept-multiclient Allows a headless server to accept multiple client connections via JSON-RPC or DAP.
|
|
--allow-non-terminal-interactive Allows interactive sessions of Delve that don't have a terminal as stdin, stdout and stderr
|
|
--api-version int Selects JSON-RPC API version when headless. New clients should use v2. Can be reset via RPCServer.SetApiVersion. See Documentation/api/json-rpc/README.md. (default 1)
|
|
--check-go-version Exits if the version of Go in use is not compatible (too old or too new) with the version of Delve. (default true)
|
|
--headless Run debug server only, in headless mode. Server will accept both JSON-RPC or DAP client connections.
|
|
--init string Init file, executed by the terminal client.
|
|
-l, --listen string Debugging server listen address. (default "127.0.0.1:0")
|
|
--log Enable debugging server logging.
|
|
--log-dest string Writes logs to the specified file or file descriptor (see 'dlv help log').
|
|
--log-output string Comma separated list of components that should produce debug output (see 'dlv help log')
|
|
--only-same-user Only connections from the same user that started this instance of Delve are allowed to connect. (default true)
|
|
```
|
|
|
|
### SEE ALSO
|
|
|
|
* [dlv](dlv.md) - Delve is a debugger for the Go programming language.
|
|
|