github.com/neilgarb/delve@v1.9.2-nobreaks/Documentation/usage/dlv.md (about)

     1  ## dlv
     2  
     3  Delve is a debugger for the Go programming language.
     4  
     5  ### Synopsis
     6  
     7  Delve is a source level debugger for Go programs.
     8  
     9  Delve enables you to interact with your program by controlling the execution of the process,
    10  evaluating variables, and providing information of thread / goroutine state, CPU register state and more.
    11  
    12  The goal of this tool is to provide a simple yet powerful interface for debugging Go programs.
    13  
    14  Pass flags to the program you are debugging using `--`, for example:
    15  
    16  `dlv exec ./hello -- server --config conf/config.toml`
    17  
    18  ### Options
    19  
    20  ```
    21        --accept-multiclient               Allows a headless server to accept multiple client connections via JSON-RPC or DAP.
    22        --allow-non-terminal-interactive   Allows interactive sessions of Delve that don't have a terminal as stdin, stdout and stderr
    23        --api-version int                  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. (default 1)
    24        --backend string                   Backend selection (see 'dlv help backend'). (default "default")
    25        --build-flags string               Build flags, to be passed to the compiler. For example: --build-flags="-tags=integration -mod=vendor -cover -v"
    26        --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)
    27        --disable-aslr                     Disables address space randomization
    28        --headless                         Run debug server only, in headless mode. Server will accept both JSON-RPC or DAP client connections.
    29    -h, --help                             help for dlv
    30        --init string                      Init file, executed by the terminal client.
    31    -l, --listen string                    Debugging server listen address. (default "127.0.0.1:0")
    32        --log                              Enable debugging server logging.
    33        --log-dest string                  Writes logs to the specified file or file descriptor (see 'dlv help log').
    34        --log-output string                Comma separated list of components that should produce debug output (see 'dlv help log')
    35        --only-same-user                   Only connections from the same user that started this instance of Delve are allowed to connect. (default true)
    36    -r, --redirect stringArray             Specifies redirect rules for target process (see 'dlv help redirect')
    37        --wd string                        Working directory for running the program.
    38  ```
    39  
    40  ### SEE ALSO
    41  
    42  * [dlv attach](dlv_attach.md)	 - Attach to running process and begin debugging.
    43  * [dlv connect](dlv_connect.md)	 - Connect to a headless debug server with a terminal client.
    44  * [dlv core](dlv_core.md)	 - Examine a core dump.
    45  * [dlv dap](dlv_dap.md)	 - Starts a headless TCP server communicating via Debug Adaptor Protocol (DAP).
    46  * [dlv debug](dlv_debug.md)	 - Compile and begin debugging main package in current directory, or the package specified.
    47  * [dlv exec](dlv_exec.md)	 - Execute a precompiled binary, and begin a debug session.
    48  * [dlv replay](dlv_replay.md)	 - Replays a rr trace.
    49  * [dlv run](dlv_run.md)	 - Deprecated command. Use 'debug' instead.
    50  * [dlv test](dlv_test.md)	 - Compile test binary and begin debugging program.
    51  * [dlv trace](dlv_trace.md)	 - Compile and begin tracing program.
    52  * [dlv version](dlv_version.md)	 - Prints version.
    53  
    54  * [dlv log](dlv_log.md)	 - Help about logging flags
    55  * [dlv backend](dlv_backend.md)	 - Help about the `--backend` flag