dlv_exec.md 2.7 KB
Newer Older
1 2
## dlv exec

3
Execute a precompiled binary, and begin a debug session.
4 5 6

### Synopsis

7 8 9 10 11
Execute a precompiled binary and begin a debug session.

This command will cause Delve to exec the binary and immediately attach to it to
begin a new debug session. Please note that if the binary was not compiled with
optimizations disabled, it may be difficult to properly debug it. Please
12 13
consider compiling debugging binaries with -gcflags="all=-N -l" on Go 1.10
or later, -gcflags="-N -l" on earlier versions of Go.
14 15

```
16
dlv exec <path/to/binary> [flags]
17 18
```

19 20 21
### Options

```
22
      --continue     Continue the debugged process on start.
23
  -h, --help         help for exec
24
      --tty string   TTY to use for the target program
25 26
```

27 28 29
### Options inherited from parent commands

```
30 31 32 33
      --accept-multiclient               Allows a headless server to accept multiple client connections.
      --allow-non-terminal-interactive   Allows interactive sessions of Delve that don't have a terminal as stdin, stdout and stderr
      --api-version int                  Selects 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")
34
      --build-flags string               Build flags, to be passed to the compiler. For example: --build-flags="-tags=integration -mod=vendor -cover -v"
35
      --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)
36
      --disable-aslr                     Disables address space randomization
37 38 39 40 41 42 43 44 45
      --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 "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)
  -r, --redirect stringArray             Specifies redirect rules for target process (see 'dlv help redirect')
      --wd string                        Working directory for running the program.
46 47 48
```

### SEE ALSO
49

50 51
* [dlv](dlv.md)	 - Delve is a debugger for the Go programming language.