.nh
.TH "DLV" "1" "Jul 2021" "" "General Commands Manual"

.SH NAME
.PP
dlv \- Delve is a debugger for the Go programming language.


.SH SYNOPSIS
.PP
\fBdlv [flags]\fP


.SH DESCRIPTION
.PP
Delve is a source level debugger for Go programs.

.PP
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.

.PP
The goal of this tool is to provide a simple yet powerful interface for debugging Go programs.

.PP
Pass flags to the program you are debugging using \fB\fC\-\-\fR, for example:

.PP
\fB\fCdlv exec ./hello \-\- server \-\-config conf/config.toml\fR


.SH OPTIONS
.PP
\fB\-\-accept\-multiclient\fP[=false]
	Allows a headless server to accept multiple client connections.

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

.PP
\fB\-\-api\-version\fP=1
	Selects API version when headless. New clients should use v2. Can be reset via RPCServer.SetApiVersion. See Documentation/api/json\-rpc/README.md.

.PP
\fB\-\-backend\fP="default"
	Backend selection (see 'dlv help backend').

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

.PP
\fB\-\-check\-go\-version\fP[=true]
	Checks that the version of Go in use is compatible with Delve.

.PP
\fB\-\-disable\-aslr\fP[=false]
	Disables address space randomization

.PP
\fB\-\-headless\fP[=false]
	Run debug server only, in headless mode.

.PP
\fB\-h\fP, \fB\-\-help\fP[=false]
	help for dlv

.PP
\fB\-\-init\fP=""
	Init file, executed by the terminal client.

.PP
\fB\-l\fP, \fB\-\-listen\fP="127.0.0.1:0"
	Debugging server listen address.

.PP
\fB\-\-log\fP[=false]
	Enable debugging server logging.

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

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

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

.PP
\fB\-r\fP, \fB\-\-redirect\fP=[]
	Specifies redirect rules for target process (see 'dlv help redirect')

.PP
\fB\-\-wd\fP=""
	Working directory for running the program.


.SH SEE ALSO
.PP
\fBdlv\-attach(1)\fP, \fBdlv\-connect(1)\fP, \fBdlv\-core(1)\fP, \fBdlv\-dap(1)\fP, \fBdlv\-debug(1)\fP, \fBdlv\-exec(1)\fP, \fBdlv\-replay(1)\fP, \fBdlv\-run(1)\fP, \fBdlv\-test(1)\fP, \fBdlv\-trace(1)\fP, \fBdlv\-version(1)\fP