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
49 lines
2.4 KiB
Markdown
49 lines
2.4 KiB
Markdown
## dlv attach
|
|
|
|
Attach to running process and begin debugging.
|
|
|
|
### Synopsis
|
|
|
|
Attach to an already running process and begin debugging it.
|
|
|
|
This command will cause Delve to take control of an already running process, and
|
|
begin a new debug session. When exiting the debug session you will have the
|
|
option to let the process continue or kill it.
|
|
|
|
|
|
```
|
|
dlv attach pid [executable] [flags]
|
|
```
|
|
|
|
### Options
|
|
|
|
```
|
|
--continue Continue the debugged process on start.
|
|
-h, --help help for attach
|
|
--waitfor string Wait for a process with a name beginning with this prefix
|
|
--waitfor-duration float Total time to wait for a process
|
|
--waitfor-interval float Interval between checks of the process list, in millisecond (default 1)
|
|
```
|
|
|
|
### 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)
|
|
--backend string Backend selection (see 'dlv help backend'). (default "default")
|
|
--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.
|
|
|