NAME¶

dlv - Delve is a debugger for the Go programming language.

SYNOPSIS¶

dlv [flags]

DESCRIPTION¶

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[=false] Allows a headless server to accept multiple client connections via JSON-RPC or DAP.

--allow-non-terminal-interactive[=false] Allows interactive sessions of Delve that don't have a terminal as stdin, stdout and stderr

--api-version=1 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.

--backend="default" Backend selection (see 'dlv help backend').

--build-flags="" Build flags, to be passed to the compiler. For example: --build-flags="-tags=integration -mod=vendor -cover -v"

--check-go-version[=true] Exits if the version of Go in use is not compatible (too old or too new) with the version of Delve.

--disable-aslr[=false] Disables address space randomization

--headless[=false] Run debug server only, in headless mode. Server will accept both JSON-RPC or DAP client connections.

-h, --help[=false] help for dlv

--init="" Init file, executed by the terminal client.

-l, --listen="127.0.0.1:0" Debugging server listen address. Prefix with 'unix:' to use a unix domain socket.

--log[=false] Enable debugging server logging.

--log-dest="" Writes logs to the specified file or file descriptor (see 'dlv help log').

--log-output="" Comma separated list of components that should produce debug output (see 'dlv help log')

--only-same-user[=true] Only connections from the same user that started this instance of Delve are allowed to connect.

-r, --redirect=[] Specifies redirect rules for target process (see 'dlv help redirect')

--wd="" Working directory for running the program.

SEE ALSO¶

dlv-attach(1), dlv-connect(1), dlv-core(1), dlv-dap(1), dlv-debug(1), dlv-exec(1), dlv-replay(1), dlv-test(1), dlv-trace(1), dlv-version(1)