.nh
.TH "DLV\-TEST" "1" "Jul 2021" "Auto generated by spf13/cobra" "General Commands Manual"

.SH NAME
.PP
dlv\-test \- Compile test binary and begin debugging program.


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


.SH DESCRIPTION
.PP
Compiles a test binary with optimizations disabled and begins a new debug session.

.PP
The test command allows you to begin a new debug session in the context of your
unit tests. By default Delve will debug the tests in the current directory.
Alternatively you can specify a package name, and Delve will debug the tests in
that package instead. Double\-dashes \fB\fC\-\-\fR can be used to pass arguments to the test program:

.PP
dlv test [package] \-\- \-test.v \-other\-argument

.PP
See also: 'go help testflag'.


.SH OPTIONS
.PP
\fB\-h\fP, \fB\-\-help\fP[=false]
	help for test

.PP
\fB\-\-output\fP="debug.test"
	Output path for the binary.


.SH OPTIONS INHERITED FROM PARENT COMMANDS
.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\-\-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(1)\fP