DLV-DEBUG(1)

📦
version 1.27.1 · 7 versions
, in ubuntu stonking

💖 DLV-DEBUG(1) 💖

okay bestie, welcome to the General Commands Manual era — this is dlv-debug, like, the debug command for Delve 🦋 and she is so good at her job.

✨ NAME ✨

dlv-debug — compile and begin debugging the main package in the current directory, or whatever package you point at. no cap.

🎀 SYNOPSIS 🎀

dlv debug [package] [flags]

🌸 DESCRIPTION 🌸

So the way this works is: Delve compiles your program with optimizations disabled, then starts it and attaches to it. that's it, that's the whole vibe 💅

By default — like, no arguments at all — Delve will compile the main package in the current directory and start debugging it. main character behavior honestly. 🌟

But alternatively?? you can specify a package name, and Delve will compile that package instead and begin a brand new debug session. slay. 🔥

👑 OPTIONS 👑

  • --continue[=false] — continue the debugged process on start. yeah, just keep it running, periodt.
  • -h, --help[=false] — help for debug 🫶 (for when you're lost, we've all been there)
  • --output="" — output path for the binary. tell her where to put the goods ✨
  • --rr-cleanup[=true] — delete the directory containing the debug recording on detach. bye bye recording directory 🧹
  • --tty="" — TTY to use for the target program 🌈

💜 OPTIONS INHERITED FROM PARENT COMMANDS 💜

these are the ones she inherited from dlv herself, iconic family tree 💖

  • --accept-multiclient[=false] — allows a headless server to accept multiple client connections via JSON-RPC or DAP. the more the merrier 🎉
  • --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 the 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. she's picky, and honestly? valid.
  • --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. no face, all brain 🧠
  • --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. exclusive fr fr 🔒
  • -r, --redirect=[] — specifies redirect rules for target process (see 'dlv help redirect') 🔀
  • --wd="" — working directory for running the program.

🌟 SEE ALSO 🌟

lowkey a whole moment that this page was auto generated by spf13/cobra, and bestie it's dated Aug 2026 — so like, go forth and debug, you absolute icon, you got this 🎀💖✨🦋
📦 where this page comes from