---
name: "dlv"
section: "1"
platform: "linux"
package: "delve"
version: "1.24.0-4+b4"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/dlv"
---

# dlv(1)

Delve is a debugger for the Go programming language.

## 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**=2\
 	Selects JSON-RPC API version when headless. The only valid value is 2. 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-attach/1.md)**, **[dlv-connect(1)](/dlv-connect/1.md)**, **[dlv-core(1)](/dlv-core/1.md)**, **[dlv-dap(1)](/dlv-dap/1.md)**, **[dlv-debug(1)](/dlv-debug/1.md)**, **[dlv-exec(1)](/dlv-exec/1.md)**, **[dlv-replay(1)](/dlv-replay/1.md)**, **[dlv-test(1)](/dlv-test/1.md)**, **[dlv-trace(1)](/dlv-trace/1.md)**, **[dlv-version(1)](/dlv-version/1.md)**