[ { "path": ".cirrus.yml", "content": "env:\n GOFLAGS: -mod=vendor\n\nfreebsd_instance:\n image_family: freebsd-14-3\n\ntest_task:\n install_script: pkg install -y go gcc git\n test_script: make test\n" }, { "path": ".gitattributes", "content": "pkg/version/version.go ident\n" }, { "path": ".github/ISSUE_TEMPLATE/config.yml", "content": "blank_issues_enabled: true\n" }, { "path": ".github/ISSUE_TEMPLATE/issue_template.yml", "content": "name: Bug Report\ndescription: File a bug report.\nbody:\n - type: input\n id: delve_version\n attributes:\n label: What version of Delve are you using (`dlv version`)?\n validations:\n required: true\n - type: input\n id: go_version\n attributes:\n label: What version of Go are you using? (`go version`)?\n validations:\n required: true\n - type: input\n id: platform\n attributes:\n label: What operating system and processor architecture are you using?\n validations:\n required: true\n - type: textarea\n id: what\n attributes:\n label: Description\n value: |\n If this is about source listing not showing up (or breakpoints not being accepted) while running in a container please read our [FAQ](https://github.com/go-delve/delve/blob/master/Documentation/faq.md#substpath) first.\n \n 1. What did you do?\n 2. What did you expect to see?\n 3. What did you see instead?\n \n Note: Please include any substantial examples (debug session output, stacktraces, etc) as linked gists.\n" }, { "path": ".github/workflows/release.yml", "content": "name: Release\n\non:\n push:\n tags:\n - 'v*'\n workflow_dispatch:\n inputs:\n tag:\n description: 'Git tag to release (e.g. v1.24.0). Required for non-dry-run releases.'\n type: string\n required: false\n dry_run:\n description: 'Dry run only (snapshot build, not published to GitHub Releases)'\n type: boolean\n default: true\n\n# Cancel in-progress runs for the same ref.\nconcurrency:\n group: \"${{ github.ref }}-release\"\n cancel-in-progress: false\n\npermissions:\n contents: write # create GitHub Release and upload assets\n id-token: write # cosign OIDC for keyless signing\n\njobs:\n release:\n runs-on: ubuntu-latest\n steps:\n - name: Validate tag input\n if: github.event_name == 'workflow_dispatch' && inputs.dry_run == false && inputs.tag == ''\n run: |\n echo \"::error::A tag must be specified for non-dry-run releases\"\n exit 1\n\n - name: Checkout\n uses: actions/checkout@v4\n with:\n fetch-depth: 0 # full history required for goreleaser release notes\n ref: ${{ inputs.tag || github.ref }}\n\n - name: Set up Go\n uses: actions/setup-go@v5\n with:\n go-version: stable\n\n - name: Install cosign\n uses: sigstore/cosign-installer@v3\n\n - name: Run goreleaser (release)\n if: github.event_name == 'push' || (github.event_name == 'workflow_dispatch' && inputs.dry_run == false)\n uses: goreleaser/goreleaser-action@v6\n with:\n version: ~> v2\n args: release --clean\n env:\n GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}\n GORELEASER_CURRENT_TAG: ${{ inputs.tag || github.ref_name }}\n\n - name: Run goreleaser (snapshot)\n if: github.event_name == 'workflow_dispatch' && inputs.dry_run == true\n uses: goreleaser/goreleaser-action@v6\n with:\n version: ~> v2\n args: release --snapshot --clean\n env:\n GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}\n\n - name: Upload snapshot artifacts\n if: github.event_name == 'workflow_dispatch' && inputs.dry_run == true\n uses: actions/upload-artifact@v4\n with:\n name: snapshot-dist\n path: dist/\n retention-days: 7\n" }, { "path": ".github/workflows/test-windows-arm64.yml", "content": "name: Test Windows ARM64\n\non:\n push:\n pull_request:\n branches: [master]\n\n# Cancel existing runs if user makes another push.\nconcurrency:\n group: \"${{ github.ref }}-${{ github.workflow}}\"\n cancel-in-progress: ${{ github.event_name == 'pull_request' }}\n\njobs:\n test-windows-arm64:\n runs-on: windows-11-arm\n timeout-minutes: 90\n\n strategy:\n fail-fast: false\n matrix:\n go-version: [\"1.24\", \"1.25\", \"tip\"]\n\n steps:\n - name: Checkout code\n uses: actions/checkout@v5\n\n - name: Run tests\n run: _scripts/test_windows.ps1 -version go${{ matrix.go-version }} -arch arm64 -binDir $env:RUNNER_TOOL_CACHE\n continue-on-error: ${{ matrix.go-version == 'tip' }}\n" }, { "path": ".gitignore", "content": "**/*.test\n.tags*\ntags\n.dbg_history\n**/**/dlv\n!cmd/dlv/\n.vagrant\n**/*.swp\nlocaltests\n.idea\n*.iml\n.teamcity/target\n.vscode\n.claude\ndist/\n" }, { "path": ".goreleaser.yaml", "content": "version: 2\n\nproject_name: dlv\n\nbefore:\n hooks:\n - go mod download\n\nbuilds:\n - main: ./cmd/dlv\n binary: dlv\n # CGO is left at its default: enabled for native builds, automatically\n # disabled by the Go toolchain when cross-compiling. This means linux/amd64\n # release binaries are built with CGO on a linux/amd64 CI runner, while all\n # cross-compiled targets (darwin, windows, linux/arm64, etc.) use pure Go.\n goos:\n - linux\n - darwin\n - windows\n goarch:\n - amd64\n - arm64\n - \"386\"\n - ppc64le\n ignore:\n # darwin and windows only support amd64 and arm64 in this release config.\n # riscv64 and loong64 are supported by Delve but excluded here because\n # goreleaser cross-compilation toolchains for those targets are not yet\n # available in standard CI environments.\n - goos: darwin\n goarch: \"386\"\n - goos: darwin\n goarch: ppc64le\n - goos: windows\n goarch: \"386\"\n - goos: windows\n goarch: ppc64le\n ldflags:\n - -X main.Build={{.FullCommit}}\n\narchives:\n - formats:\n - tar.gz\n format_overrides:\n - goos: windows\n formats:\n - zip\n name_template: \"dlv_{{ .Version }}_{{ .Os }}_{{ .Arch }}\"\n\nchecksum:\n name_template: \"checksums.txt\"\n algorithm: sha256\n\n# Cosign keyless signing via Sigstore. Signing runs automatically in GitHub\n# Actions with `id-token: write` permission — cosign v2 auto-detects the\n# GitHub Actions OIDC identity. No private key or secret is required.\n# To verify: cosign verify-blob --certificate .cert --signature .sig \nsigns:\n - cmd: cosign\n certificate: \"${artifact}.cert\"\n args:\n - sign-blob\n - \"--output-certificate=${certificate}\"\n - \"--output-signature=${signature}\"\n - \"${artifact}\"\n - --yes\n artifacts: checksum\n output: true\n\nrelease:\n github:\n owner: go-delve\n name: delve\n\nsnapshot:\n version_template: \"{{ .Tag }}-next\"\n" }, { "path": ".teamcity/pom.xml", "content": "\n\n 4.0.0\n Delve Config DSL Script\n Delve\n Delve_dsl\n 1.0-SNAPSHOT\n\n \n org.jetbrains.teamcity\n configs-dsl-kotlin-parent\n 1.0-SNAPSHOT\n \n\n \n \n jetbrains-all\n https://download.jetbrains.com/teamcity-repository\n \n true\n \n \n \n teamcity-server\n https://delve.teamcity.com/app/dsl-plugins-repository\n \n true\n \n \n \n\n \n \n JetBrains\n https://download.jetbrains.com/teamcity-repository\n \n \n\n \n ${basedir}\n \n \n kotlin-maven-plugin\n org.jetbrains.kotlin\n ${kotlin.version}\n\n \n \n \n compile\n process-sources\n \n compile\n \n \n \n test-compile\n process-test-sources\n \n test-compile\n \n \n \n \n \n org.jetbrains.teamcity\n teamcity-configs-maven-plugin\n ${teamcity.dsl.version}\n \n kotlin\n target/generated-configs\n \n \n \n \n\n \n \n org.jetbrains.teamcity\n configs-dsl-kotlin-latest\n ${teamcity.dsl.version}\n compile\n \n \n org.jetbrains.teamcity\n configs-dsl-kotlin-plugins-latest\n 1.0-SNAPSHOT\n pom\n compile\n \n \n org.jetbrains.kotlin\n kotlin-stdlib-jdk8\n ${kotlin.version}\n compile\n \n \n org.jetbrains.kotlin\n kotlin-script-runtime\n ${kotlin.version}\n compile\n \n \n" }, { "path": ".teamcity/settings.kts", "content": "import jetbrains.buildServer.configs.kotlin.AbsoluteId\nimport jetbrains.buildServer.configs.kotlin.BuildType\nimport jetbrains.buildServer.configs.kotlin.DslContext\nimport jetbrains.buildServer.configs.kotlin.Project\nimport jetbrains.buildServer.configs.kotlin.buildFeatures.PullRequests\nimport jetbrains.buildServer.configs.kotlin.buildFeatures.commitStatusPublisher\nimport jetbrains.buildServer.configs.kotlin.buildFeatures.golang\nimport jetbrains.buildServer.configs.kotlin.buildFeatures.pullRequests\nimport jetbrains.buildServer.configs.kotlin.buildSteps.dockerCommand\nimport jetbrains.buildServer.configs.kotlin.buildSteps.exec\nimport jetbrains.buildServer.configs.kotlin.buildSteps.powerShell\nimport jetbrains.buildServer.configs.kotlin.failureConditions.BuildFailureOnMetric\nimport jetbrains.buildServer.configs.kotlin.failureConditions.failOnMetricChange\nimport jetbrains.buildServer.configs.kotlin.project\nimport jetbrains.buildServer.configs.kotlin.triggers.schedule\nimport jetbrains.buildServer.configs.kotlin.triggers.vcs\nimport jetbrains.buildServer.configs.kotlin.version\n\n/*\nThe settings script is an entry point for defining a TeamCity\nproject hierarchy. The script should contain a single call to the\nproject() function with a Project instance or an init function as\nan argument.\n\nVcsRoots, BuildTypes, Templates, and subprojects can be\nregistered inside the project using the vcsRoot(), buildType(),\ntemplate(), and subProject() methods respectively.\n\nTo debug settings scripts in command-line, run the\n\n mvnDebug org.jetbrains.teamcity:teamcity-configs-maven-plugin:generate\n\ncommand and attach your debugger to the port 8000.\n\nTo debug in IntelliJ Idea, open the 'Maven Projects' tool window (View\n-> Tool Windows -> Maven Projects), find the generate task node\n(Plugins -> teamcity-configs -> teamcity-configs:generate), the\n'Debug' option is available in the context menu for the task.\n*/\n\nversion = \"2023.05\"\n\nval targets = arrayOf(\n \"linux/amd64/1.24\",\n \"linux/amd64/1.25\",\n \"linux/amd64/1.26\",\n \"linux/amd64/tip\",\n\n \"linux/386/1.26\",\n\n \"linux/arm64/1.26\",\n \"linux/arm64/tip\",\n\n \"linux/ppc64le/1.26\",\n\n // \"linux/riscv64/1.26\", // needs exp.linuxriscv64 build tag, disabled due to CI issues\n\n \"windows/amd64/1.26\",\n \"windows/amd64/tip\",\n\n \"mac/amd64/1.26\",\n \"mac/amd64/tip\",\n\n \"mac/arm64/1.26\",\n \"mac/arm64/tip\"\n)\n\nproject {\n val tests = targets.map { target ->\n val (os, arch, version) = target.split(\"/\")\n TestBuild(os, arch, version, AbsoluteId(\"Delve_${os}_${arch}_${version.replace('.', '_')}\"))\n }\n tests.map { test ->\n test.os\n }.distinct().forEach { os ->\n subProject(OSProject(os, tests.filter { test ->\n test.os == os && test.version != \"tip\"\n }))\n }\n subProject(TipProject(tests.filter { test ->\n test.version == \"tip\"\n }))\n buildType(AggregatorBuild(tests.filter { test ->\n test.version != \"tip\"\n }))\n params {\n param(\"teamcity.ui.settings.readOnly\", \"true\")\n param(\"env.CI\", \"true\")\n }\n}\n\nclass AggregatorBuild(tests: Collection) : BuildType({\n name = \"Aggregator\"\n type = Type.COMPOSITE\n\n vcs {\n root(DslContext.settingsRoot)\n }\n\n triggers {\n vcs {\n }\n }\n\n dependencies {\n tests.forEach { test ->\n snapshot(test) {\n }\n }\n }\n\n features {\n pullRequests {\n vcsRootExtId = \"${DslContext.settingsRoot.id}\"\n provider = github {\n authType = token {\n token = \"credentialsJSON:1312c856-0e13-4b04-8c40-ac26d4a5f700\"\n }\n filterAuthorRole = PullRequests.GitHubRoleFilter.EVERYBODY\n }\n }\n commitStatusPublisher {\n vcsRootExtId = \"${DslContext.settingsRoot.id}\"\n publisher = github {\n githubUrl = \"https://api.github.com\"\n authType = personalToken {\n token = \"credentialsJSON:1312c856-0e13-4b04-8c40-ac26d4a5f700\"\n }\n }\n param(\"github_oauth_user\", \"\")\n }\n }\n\n failureConditions {\n executionTimeoutMin = 60\n }\n})\n\nclass TipProject(tests: List) : Project({\n id = AbsoluteId(\"Delve_tip\")\n name = \"Tip\"\n\n tests.forEach { test ->\n buildType(test)\n }\n})\n\nclass OSProject(os: String, tests: List) : Project({\n id = AbsoluteId(\"Delve_$os\")\n name = os.capitalize()\n\n tests.map { test ->\n test.arch\n }.distinct().forEach { arch ->\n subProject(ArchProject(os, arch, tests.filter { test ->\n test.arch == arch\n }))\n }\n})\n\nclass ArchProject(os: String, arch: String, tests: List) : Project({\n id = AbsoluteId(\"Delve_${os}_${arch}\")\n name = arch\n\n tests.forEach { test ->\n buildType(test)\n }\n})\n\nclass TestBuild(val os: String, val arch: String, val version: String, buildId: AbsoluteId) : BuildType({\n id = buildId\n name = if (version == \"tip\") \"${os}_${arch}_tip\" else version\n\n vcs {\n root(DslContext.settingsRoot)\n branchFilter = if (version == \"tip\") {\n \"\"\"\n +:*\n -:pull/*\n \"\"\".trimIndent()\n } else {\n \"+:*\"\n }\n }\n\n if (version == \"tip\") {\n triggers {\n schedule {\n schedulingPolicy = daily {\n hour = 23\n }\n withPendingChangesOnly = true\n triggerBuild = always()\n }\n }\n }\n\n failureConditions {\n executionTimeoutMin = 30\n\n if (version != \"tip\") {\n failOnMetricChange {\n metric = BuildFailureOnMetric.MetricType.TEST_COUNT\n units = BuildFailureOnMetric.MetricUnit.DEFAULT_UNIT\n comparison = BuildFailureOnMetric.MetricComparison.LESS\n compareTo = value()\n }\n }\n }\n\n steps {\n when (os) {\n \"linux\" -> {\n val dockerArch = when (arch) {\n \"386\" -> \"i386\"\n \"arm64\" -> \"arm64v8\"\n else -> {\n arch\n }\n }\n val dockerPlatformArch = when (arch) {\n \"arm64\" -> \"arm64/v8\"\n else -> {\n dockerArch\n }\n }\n val ubuntuVersion = when (arch) {\n \"riscv64\" -> \"24.04\"\n else -> \"20.04\"\n }\n dockerCommand {\n name = \"Pull Ubuntu\"\n commandType = other {\n subCommand = \"pull\"\n commandArgs = \"$dockerArch/ubuntu:$ubuntuVersion\"\n }\n }\n dockerCommand {\n name = \"Test\"\n commandType = other {\n subCommand = \"run\"\n commandArgs = \"\"\"\n -v %teamcity.build.checkoutDir%:/delve\n --env TEAMCITY_VERSION=${'$'}TEAMCITY_VERSION\n --env CI=true\n --privileged\n --platform linux/$dockerPlatformArch\n $dockerArch/ubuntu:$ubuntuVersion\n /delve/_scripts/test_linux.sh ${\"go$version\"} $arch\n \"\"\".trimIndent()\n }\n }\n }\n \"windows\" -> {\n powerShell {\n name = \"Test\"\n scriptMode = file {\n path = \"_scripts/test_windows.ps1\"\n }\n param(\"jetbrains_powershell_scriptArguments\", \"-version ${\"go$version\"} -arch $arch\")\n }\n }\n \"mac\" -> {\n exec {\n name = \"Test\"\n path = \"_scripts/test_mac.sh\"\n arguments = \"${\"go$version\"} $arch %system.teamcity.build.tempDir%\"\n }\n }\n }\n }\n\n requirements {\n when (arch) {\n \"386\", \"amd64\" -> equals(\"teamcity.agent.jvm.os.arch\", if (os == \"mac\") \"x86_64\" else \"amd64\")\n \"arm64\" -> equals(\"teamcity.agent.jvm.os.arch\", \"aarch64\")\n \"ppc64le\" -> equals(\"teamcity.agent.jvm.os.arch\", \"ppc64le\")\n \"riscv64\" -> equals(\"teamcity.agent.jvm.os.arch\", \"riscv64\")\n \"loong64\" -> equals(\"teamcity.agent.jvm.os.arch\", \"loongarch64\")\n }\n when (os) {\n \"linux\" -> {\n matches(\"teamcity.agent.jvm.os.family\", \"Linux\")\n }\n \"windows\" -> {\n matches(\"teamcity.agent.jvm.os.family\", \"Windows\")\n }\n \"mac\" -> {\n matches(\"teamcity.agent.jvm.os.family\", \"Mac OS\")\n }\n }\n }\n\n features {\n pullRequests {\n vcsRootExtId = \"${DslContext.settingsRoot.id}\"\n provider = github {\n authType = token {\n token = \"credentialsJSON:1312c856-0e13-4b04-8c40-ac26d4a5f700\"\n }\n filterAuthorRole = PullRequests.GitHubRoleFilter.EVERYBODY\n }\n }\n golang {\n testFormat = \"json\"\n }\n }\n})\n" }, { "path": "CHANGELOG.md", "content": "# Changelog\n\nAll notable changes to this project will be documented in this file.\nThis project adheres to Semantic Versioning.\n\n## [1.26.1] 2026-03-03\n\n### Added\n\n- Support for debugging stripped non-Go binaries (#4263, @derekparker)\n- Package for detecting debugger attachment (#4258, @derekparker)\n- Starlark `append_file` built-in function (#4252, @sding3)\n- DAP: Hit conditional breakpoint capability (#4230, @DrSergei)\n- Detection and warning about trimpath (#4241, @aarzilli)\n\n### Fixed\n\n- Fix debuginfod download progress (#4270, @aarzilli)\n- Fix sigpanics in swiss map iterator (#4261, @derekparker)\n- Fix finding moduledata in Go 1.26+ (#4228, @derekparker)\n- Fix goroutine leak and shutdown sequence for eBPF backend (#4231, @derekparker)\n- Fix eBPF uprobe placement to skip function prologue (#4249, @derekparker)\n- Fix `ProducerAfterOrEqual` comparison for devel builds (#4234, @typesanitizer)\n- DAP: Better error messages when debugger can't be launched (#4264, @aarzilli)\n- DAP: Reject most requests before launch/attach (#4240, @aarzilli)\n- Propagate short type option when printing structs (#4235, @igadmg)\n- Better error if process is already being debugged (#4242, @aarzilli)\n- Print error when request body can't be decoded (#4247, @aarzilli)\n- Parse rc version with trailing suffix (#4255, @alexsaezm)\n\n### Changed\n\n- Migrate from gopkg.in/yaml.v3 to go.yaml.in/yaml/v3 (#4257, @scop)\n- Update waitReason switch for Go 1.27 (#4244, @typesanitizer)\n- Downgrade riscv64 support (#4232, @derekparker)\n- Miscellaneous code quality improvements (#4221, #4226, #4259, #4262, #4224, @derekparker, @aarzilli)\n- Miscellaneous improvements to tests, documentation, and build configuration (#4250, #4254, #4248, #4265, @derekparker, @aarzilli, @stack1ng)\n\n## [1.26.0] 2025-12-18\n\n### Added\n\n- Go 1.26 support (#4211, #4205, #4212, #4217, @aarzilli)\n- Savestate command for terminal (#4045, @alexsaezm)\n- DAP: Target command and follow-exec support (#4078, @Lslightly)\n- DAP: Read memory request handler (#4083, @MistaTwista)\n- DAP: Input/output redirection (#4178, @aarzilli)\n- DAP: Suspended breakpoints support (#4075, @firelizzard18)\n- DAP: Use exception breakpoints for predefined breakpoints (#4169, @aarzilli)\n- Custom starlark commands can be used with on prefix (#4170, @derekparker)\n- Shortcut syntax to access target variables in starlark (#4134, @aarzilli)\n- Support for tracing defer function calls with follow option (#3978, @archanaravindar)\n- Flag to retain trace directory after detach (#4091, @archanaravindar)\n- Ability to cancel debuginfod downloads (#4123, @aarzilli)\n- Process spawned event (#4171, @firelizzard18)\n- Materialized breakpoint event for follow-exec mode (#4161, @aarzilli)\n- Way to disable stop-on-error for breakpoint conditions (#4191, @aarzilli)\n- Function call support on loong64 (#4114, @yelvens)\n- Build argument logging (#4185, @pedia)\n- Capslock check (#4106, @derekparker)\n\n### Fixed\n\n- DAP: Restart handling when compilation fails (#4215, @aarzilli)\n- DAP: Disable string() field for address-less variables (#4214, @aarzilli)\n- DAP: Race condition in tests (#4121, @derekparker)\n- Gdbserial: Do not set detached if we kill the process (#4216, @aarzilli)\n- Prevent trace killing attached process (#4164, @alex-emery)\n- Trace /regexp/ should set ret breakpoints correctly (#4130, @aarzilli)\n- Replay subcommand must keep trace directory (#4184, @lwintermelon)\n- Nil pointer dereference when calling extra on a nil func (#4174, @aarzilli)\n- Check that breakpoint exists in ClearBreakpoint (#4141, @aarzilli)\n- Use address in ClearBreakpoint only when ID is 0 (#4168, @aarzilli)\n- Return error when calling a non-ptr receiver method on a nil ptr (#4139, @aarzilli)\n- Additional checks parsing g structs (#4140, @aarzilli)\n- Remember that we attached in WaitFor attach mode (#4120, @aarzilli)\n- Guard register logging from nil pointer dereferences (#4188, @aarzilli)\n- Do not insist stmt is same line as entry in DWARF (#4186, @derekparker)\n- Fix wait reason string table (#4182, @aarzilli)\n- Workaround for non-unicode strings in Variables (#4082, @aarzilli)\n- Fix ppc64le clause in support_sentinel_linux.go (#4129, @tshah14)\n- Improve frame unwind context handling on loong64 (#4133, @yelvens)\n\n### Changed\n\n- Replace hashicorp/golang-lru with custom lru cache (#4196, @qmuntal)\n- Update riscv64 support and add to test matrix (#4190, @lrzlin)\n- Update riscv64 capslock file (#4210, @derekparker)\n- Move things that use x/tools/go/packages to new repo (#3990, @aarzilli)\n- Remove experimental build tags for Windows ARM64 (#4176, @gdams)\n- Add Windows ARM64 workflow to CI (#4175, @gdams)\n- Add linux/loong64 to TeamCity configuration (#4154, @yelvens)\n- Set CI=true on a project level (#4156, @vietage)\n- Hierarchical search for structMember or method (#4118, @wenxuan70)\n- Update trie to v3.2.0 (#4131, @derekparker)\n- Parallelize tests where possible (#4115, @derekparker)\n- Modernize codebase with newer syntax and helpers (#4110, @derekparker)\n- Miscellaneous improvements to tests and build configuration (#4096, #4135, #4145, #4157, #4163, #4198, #4202, #4111, #4122, #4124, #4209, @derekparker, @aarzilli)\n- Miscellaneous code refactoring (#4159, #4173, #4201, @aarzilli)\n\n## [1.25.2] 2025-08-26\n\n### Added\n\n* Added notifications for debuginfod downloads (#3980, @aarzilli)\n\n### Fixed\n\n* Fixed restart behavior of DAP server (#4068, @derekparker)\n* Various fixes for loong64 backend (#4095, #4100, @yelvens)\n* Miscellaneous minor bug fixes (#4067, #4090, #4089, @aarzilli)\n\n### Changed\n\n* Miscellaneous code quality improvements (#4088, @cui)\n\n## [1.25.1] 2025-07-18\n\n### Added\n- Implement restart request for DAP (#4057, @derekparker)\n\n### Fixed\n- Fixed panic when trying to stacktrace an unreadable goroutine in DAP (#4056, @aarzilli)\n- Fixed panic when trying to access value of unreadable string variables in DAP (#4055, @aarzilli)\n- Fixed type cast between slices with the same element type (#4048, @aarzilli)\n- Fixed closure captured variables visibility on closure's first line (#4049, @aarzilli)\n- Fixed unknown DWARF opcodes causing panics (#4037, @aarzilli)\n- Added missing response body close in DAP test (#4039, @alexandear)\n- Fix panic in switchToGoroutineStacktrace (#4043, @derekparker)\n\n### Changed\n- Handle moving of direct interface flag in Go 1.26 (#4032, @randall77)\n- Simplified tests using slices.Contains (#4040, @alexandear)\n- Updated Go max support minor version and update golang.org/x/tools (#4046, @derekparker)\n\n## [1.25.0] 2025-04-16\n\n### Added\n- Go 1.25 support (#4014, @aarzilli) (more work went into the 1.24.2 and earlier releases)\n\n### Fixed\n- Fixed several panics found via telemetry (#4026, #4018, #4017, #4015 @aarzilli)\n- Fixed git hash in version output (#3987, @codeaucafe)\n- Fix development version parsing (#3999, @aarzilli)\n- Fix call injection in newer macOS versions (#3988, @aarzilli)\n- Fix typo in goroutines help output (#4024, @jersey1dev)\n\n### Changed\n- Internal breakpoints (panic, throw) are excluded from DAP response (#4027, @ConradIrwin)\n\n## [1.24.2] 2025-04-10\n\n### Added\n\n- Support for struct literals in expression evaluator (#3935, #3953, @aarzilli)\n- Check to reject DWARFv5 executables if delve itself isn't built with 1.25 or later due to bugs in Go's standard library prior to 1.25 (#3943, #3961, @aarzilli)\n\n### Fixed\n\n- Support for macOS Sequoia 15.4 (#3966, @aarzilli)\n- Race conditions with rr backend (#3971, #3973, #3963, @BronzeDeer, @aarzilli)\n- Goroutine load with corrupted label maps (#3968, #3962, @hongyuh-hh)\n- Breakpoint conditions on suspended breakpoints (#3938, @Lslightly)\n\n### Changed\n\n- Miscellaneous test and documentation fixes (#3979, #3952, #3954, #3955, #3951, @alexandear, @codesoap, @derekparker)\n\n## [1.24.1] 2025-03-05\n\n### Added\n\n- Support for linux/loong64 in native backend (#3892, @yelvens)\n- Support for watchpoints on interface values (#3922, #3924, @derekparker)\n- Improved support for DWARFv5 (#3893, @aarzilli)\n- Telemetry stack counters for internal errors (#3930, @aarzilli)\n- Support for zed editor and allow args in DELVE_EDITOR (#3899, @derekparker)\n\n### Fixed\n\n- Fix uprobe address in ebpf implementation (#3894, @3u13r)\n- Provide process events after launch in DAP (#3902, @shaunduncan)\n- Use rr version to determine style of qRRCmd (#3921, @aarzilli)\n- Better error message for breakpoints on stripped binaries (#3914, @aarzilli)\n- Switch to goroutine stack if no progress on thread stack (#3898, @aarzilli)\n- Handle wider registers in test (#3929, @derekparker)\n\n### Changed\n\n- Replace logrus with log/slog (#3918, @aarzilli)\n- Remove uses of reflect.MethodByName from all of Delve (#3916, @aarzilli)\n- Refactor sort.Sort to slices.SortFunc (#3880, @alexandear)\n- Allow access to thread registers after a function call (#3908, @aarzilli)\n- Remove riscv64 from TeamCity configuration (#3912, @aarzilli)\n\n## [1.24.0] 2024-12-18\n\n### Added\n\n- Support for Go 1.24, particularly the new swiss table map implementation (#3882, #3879, #3838, @aarzilli)\n- Import go telemetry and enable crash reporting (#3841, @hyangah)\n- Enable stepping into coroutine (#3791, @aarzilli)\n- Add raw examinemem dump (#3721, @aarzilli)\n- Add linux-riscv64 support (experimental) (#3785, @lrzlin)\n- Automatically guessing substitute-path config (#3781, @aarzilli)\n- Print a message when the debuggee process exits while Delve in headless mode (#3870, @jakejx)\n- Allow accessing closure captured variable as if they were struct fields (#3866, @aarzilli)\n- Add dape to list of plugins (#3817, @jgarte)\n\n### Fixed\n\n- Fix step stuttering when entering range-over-func bodies (#3788, @aarzilli)\n- Fix formatting of autogenerated documentation (#3836, @aarzilli)\n- Fix issue on Windows when launching process while detached (#3867, @aarzilli)\n- Fix handling of unsatisfiable breakpoints during restart (#3868, @aarzilli)\n\n### Changed\n\n- Update 'client-addr' to support Unix domain sockets (#3819, @n1lesh)\n- Adds pointer pinning to call injection, improving function calls during debug session (#3787, @aarzilli)\n- Allow modification of starlark structs returned by API (#3872, @aarzilli)\n- API V1 has been removed following the deprecation from last version (#3881, @aarzilli)\n\n## [1.23.1] 2024-09-23\n\nTelemetry notice: starting with version 1.24.0 Delve will begin collecting opt-in telemetry data using the same mechanism used by the toolchain, see , , .\n\n### Fixed\n\n- Debugging on macOS Sequoia (#3799, @aarzilli)\n- Various bugs with range-over-func loops (#3808, #3788, @aarzilli)\n- Reslice operator did not allow reslicing up to the slice's cap (#3796, @Jille)\n- Starlark access to named constants (#3802, @arvidfm)\n\n\n## [1.23.0] 2024-07-16\n\nDeprecation notice: starting with the next version of Delve version 1 of the API will be removed. Version 2 was added in version 0.12.0 in 2017 and has been the recommended way to connect to Delve since.\n\n### Added\n\n- Support for Go 1.23, particularly the new range-over-func statement (#3663, #3697, #3736, #3738, #3750, #3755, #3763, #3778, @aarzilli)\n- `next-instruction` command (#3671, @derekparker)\n- Support reading captured variables of closure functions (#3682, @aarzilli)\n- Breakpoint command `break` now allows adding a condition the a breakpoint with a postfix notation (`break if `) (#3693, #3702, @derekparker)\n- When the `step` command is executed on `go funccall()` statements it will stop on the newly created goroutine (#3686, @aarzilli)\n- Invocation of [rr](https://github.com/rr-debugger/rr/) when it is used as a backend can be now controlled with environment variables `$DELVE_RR_RECORD_FLAGS` and `$DELVE_RR_REPLAY_FLAGS` (#3726, @aarzilli)\n- Added new suboption `--follow-calls` to trace command (#3594, @archanaravindar)\n\n### Fixed\n\n- Better behavior on stripped files (#3678, #3695, @aarzilli, @derekparker)\n- Support rr version 5.7.0 and later (#3705, #3718, @howardjohn, @aarzilli)\n- Watchpoints on newer versions of macOS (#3703, @derekparker)\n- Bug related to watchpoints going out of scope (#3742, @aarzilli)\n- Bug invoking debuginfod-find (#3762, @derekparker)\n- Miscellaneus fixes (#3707, #3761, #3759, #3767, @scop, @jayantxie, @aarzilli, @zdyj3170101136)\n\n### Changed\n\n- Improved auto-completions for shells (#3696, #3699, @scop)\n- Print more informations on tracepoint stops (#3675, #3712, @derekparker, @archanaravindar)\n- Improved performance of the default macOS backend (#3715, @derekparker)\n- When a breakpoint is hit on a headless instance of Delve while no clients are connected a message will be printed to stdout (#3632,#3747, @fatanugraha, @aarzilli)\n- Miscellaneous code and documentation improvements (#3676, #3677, #3698, #3716, #3727, #3722, #3730, #3731, #3753, #3752, #3756, #3757, #3741, #3773, #3775, #3770, #3769, #3772, #3779, #3774, @alexandear, @aarzilli, @abbasudo, @jayantxie)\n\n## [1.22.1] 2024-02-21\n\n### Added\n\n- `--listen` and `connect` now support Unix Domain Sockets (#3655, ##3658, @aarzilli)\n- Paging for commands `print`, `vars`, `args` and `locals` (#3620, @aarzilli)\n- Syntax highlighting for stacktraces and options to change the color of Delve's prompt (#3649, #3648, @aarzilli)\n- Wait-for option for DAP's attach mode (#3656, @muggle-nil)\n\n### Fixed\n\n- Bug where Ctrl-Z was not sent to other processes in the same group as Delve (#3619, @aarzilli)\n- Parsing of `/proc/net/tcp` when it has 10000 or more entries (#3660, @michaelmerg)\n- Rare error when valuating expressions containing `runtime.frame(n)` inside breakpoint conditions (#3624, @aarzilli)\n- Line number reported for the stack frame that caused a panic (#3638, @aarzilli)\n- Building when dlv's executable already exists on macOS with a signing key already installed (#3639, @ardnew)\n\n### Changed\n\n- When evaluating an expression containing a reslice operation with constant bounds the entire resulting slice will be loaded (#3623, @aarzilli)\n\n## [1.22.0] 2023-12-29\n\n### Added\n\n- Support for Go 1.22 (#3583, @aarzilli)\n- Support for min and max builtins (#3530, @aarzilli)\n- Expression evaluator can now reference previous frames (#3534, @derekparker)\n- Better support for stripped binaries (#3549, #3577, #3597, @derekparker)\n- Remove package paths from types returned by DAP (#3535, @stefanhaller)\n- Show pprof labels in DAP (#3501, @stefanhaller)\n\n### Fixed\n\n- Fixes for signal routing with debugserver (#3541, @aarzilli)\n- Clear substitute path rules cache every time the `config` command is used (#3567, @aarzilli)\n- Fixes handling of hardcoded breakpoints after a manual stop (#3582, @aarzilli)\n- Occasional close on closed channel panic in DAP (#3573, @aarzilli)\n- Correctly reports exit code on Linux when a we receive a signal close to the program's exit (#3585, @aarzilli)\n\n### Changed\n\n- Type casts from slice to string and vice versa will now use the load configuration for the target type, which is more intuitive (#3596, @aarzilli)\n- Miscellaneous improvements to documentation (#3531, #3555, #3556, #3562, #3564, #3575, #3576, @alexandear, @testwill)\n\n## [1.21.2] 2023-10-30\n\n### Added\n\n- DAP: add concrete type to interface type (@suzmue, #3510)\n- Support for VSCode in the edit command (@derekparker, #3524)\n- Follow-mode support for Windows (@aarzilli, #3507)\n\n### Fixed\n\n- Fix bugs handling stdout/stderr in DAP (@hyangah, #3522)\n- Fix bug with autogenerated wrappers for methods of generic types (@aarzilli, #3528)\n\n### Changed\n\n- Use Cgo instead of C code in the FreeBSD backend (@4a6f656c, #3529)\n- Remove obsolete build tags (+build) (@alexandear, #3513)\n\n## [1.21.1] 2023-10-3\n\n### Added\n\n- Support for linux/ppc64le (@alexsaezm)\n- Enable debugging stripped mach-o (MacOS) binaries (@pgavlin)\n- Enable function call injection for linux/ppc64le (@archanaravindar)\n- Improved support for editors in 'edit' command (@derekparker)\n- Early 1.22 support (@aarzilli)\n- Add 'packages' command to list packages in compiled binary (@hyangah)\n- Support debugging PIE binaries on linux/ppc64le (@archanaravindar)\n- Add ability to list goroutines waiting on channel (@aarzilli)\n- Add support for more argument / return type parsing in ebpf tracing backend (@derekparker)\n- Add waitfor option to 'attach' command (@aarzilli)\n\n### Fixed\n\n- Fix memory leak in native Darwin backend CGO usage (@thechampagne)\n- Fix hexadecimal printing of variables with symbolic const values (@aarzilli)\n- Handle ctrl-c during tracing executing (@derekparker)\n- Use a stack for restore/remember opcodes in DWARF CFI (@javierhonduco)\n- Pass user specified '-C' argument first in gobuild flags (@aarzilli)\n- Fix stacktraces on freebsd/amd64/go1.20 (@aarzilli)\n- Fix PIE support on macOS (@aarzilli)\n- Fix starlark slice unmarshaling (@andreimatei)\n- Restore breakpoints set with line offsets on restart (@aarzilli)\n- Check recursion level when printing pointers (@aarzilli)\n- Fix FrameDescriptionEntries' append bug removing duplicates (@gocurr)\n- Read context from sigtrampgo fixing cgo stack traces on 1.21 (@aarzilli)\n\n### Changed\n\n- Replace deprecated io/ioutil usage (@alexandear)\n- Accept string list as launch requests buildFlags in DAP server (@hyangah)\n- Strip package paths from symbols in callstack in DAP response (@stefanhaller)\n- Update cilium/ebpf package (@aarzilli)\n\n## [1.21.0] 2023-06-23\n\n### Added\n\n- Go 1.21 support (#3370, #3401, @aarzilli)\n- Basic debug functionality for stripped executables (#3408, #3421, @derekparker)\n- Core dumping on FreeBSD (#3305, @aarzilli)\n- Ability to automatically attach to child processes when they are spawned (linux-only) (#3286, #3346, @aarzilli)\n- Starlark scripts can now use the time module (#3375, @andreimatei)\n- Online help for starlark interpreter (#3388, @aarzilli)\n- `dlv trace` has a new option, `--timestamp`, that prints timestamps before every trace event (#3358, @spacewander)\n\n### Fixed\n\n- Stepping could hide normal breakpoint hits occurring simultaneously, in rare circumstances (#3287, @aarzilli)\n- Internal error when defer locations can not be resolved (#3329, @aarzilli)\n- Channels of certain types could be displayed incorrectly (#3362, @aarzilli)\n- Formatted time wouldn't always be displayed when using DAP (#3349, @suzmue)\n- Function call injection when parameters are in registers (#3365, @ZekeLu)\n- Panic in Starlark interface when using partially loaded variables (#3386, @andreimatei)\n- Use debug info directories configuration in `dlv trace` (#3405, @nozzy123nozzy)\n- Updated DAP version (#3414, @suzmue)\n\n### Changed\n\n- Improved eBPF tracepoints (#3325, #3353, #3417, @chenhengqi, @derekparker)\n- The name of the default output binary is now randomizes, which fixes some weird behavior when multiple instances of Delve are run simultaneously in the same directory (#3366, @aarzilli)\n- Stderr of debuginfod-find is now suppressed (#3381, @fche)\n- Better documentation for substitute-path (#3335, @aarzilli)\n- `quit -c` will ask for confirmation when breakpoints still exist (#3398, @aarzilli)\n- Miscellaneous improvements to documentation and tests (#3326, #3327, #3340, #3341, #3357, #3378, #3376, #3399, #3374, #3426, @alexandear, @cuishuang, @alexsaezm, @andreimatei)\n\n\n## [1.20.2] 2023-04-05\n\n### Added\n\n- New flag --rr-onprocess-pid to replay command (#3281, @jcpowermac)\n- Added documentation for watching arbitrary address (#3268, @felixge)\n- Allow extracting a DWARF entry field (#3258, @brancz)\n- Add SetLoggerFactory to terminal/logflags package (#3257, @blaubaer)\n- New config option for tab printing when printing source code (#3243, @thockin)\n- Added documentation for debugging Go runtime with Delve (#3234, @aarzilli)\n\n### Fixed\n\n- Fix printing boolean values in Starlark scripts (#3314, @vitalif)\n- Fix infinite recursion in escapeCheck (#3311, @aarzilli)\n- Support multiple functions with same name (#3297, @aarzilli)\n- Handle end_seq in dwarf/line correctly (#3277, @derekparker)\n- Fix calls into SYS_PROCESS_VM_READV/WRITEV syscalls (#3273, @aarzilli)\n- Fix exit status for trace subcommand (#3263, @derekparker)\n- Fix stripping DYLD_INSERT_LIBRARIES on macOS (#3245, @aviramha)\n- Fix handling of list colors via config (#3240, @derekparker)\n- Fixes to FreeBSD backend (#3224, @aarzilli)\n\n### Changed\n\n- Add limit to maximum time.Time we try and format (#3294, @aarzilli)\n- Add fuzzing tests to expression evaluator and variable loader (#3293, @aarzilli)\n- Removed some support for Go 1.12 and earlier (#3271, @aarzilli)\n- Moved util functions to dwarf package (#3252, @alexandear)\n- Attempt to load DW_AT_specification if present (#3247, @brancz)\n- Match go test behavior when dlv test gets list of go files (#3232, @aarzilli)\n- Populate Value field in pointer Variable (#3229, @andreimatei)\n\n## [1.20.1] 2022-12-12\n\n### Fixed\n\n- Fix executing programs on macOS with most versions of debugserver installed (#3211, @aarzilli)\n\n## [1.20.0] 2022-12-07\n\n### Added\n\n- Support for Go 1.20 (#3129, #3196, #3180, @cuiweixie, @qmuntal, @aarzilli)\n- Support for Windows/arm64 (gated by a build tag) (#3063, #3198, #3200, @qmuntal)\n- Compatibility with coredumpctl (#3195, @Foxboron)\n\n### Fixed\n\n- Improve evaluation of type casts (#3146, #3149, #3186, @aarzilli)\n- DAP: Added type to response of EvaluateRequest (#3172, @gfszr)\n- Cgo stacktraces on linux/arm64 (#3192, @derekparker)\n- Debugserver crashes on recent versions of macOS when $DYLD_INSERT_LIBRARIES is set (#3181, @aviramha)\n- Stacktraces and stepping on Go 1.19.2 and later on macOS (#3204, @aarzilli)\n- Attaching to processes used by a different user on Windows (#3162, @aarzilli)\n- Nil pointer dereference when current address is not part of a function (#3157, @aarzilli)\n\n### Changed\n\n- Change behavior of exec command so that it looks for the executable in the current directory (#3167, @derekparker)\n- DAP shows full value when evaluating log messages (#3141, @suzmue)\n- Wait time is no longer reported for parked goroutines (its value was always incorrect) (#3139, @aarzilli)\n- Miscellaneous improvements to documentation and error messages (#3119, #3117, #3154, #3161, #3169, #3188, @aarzilli, @derekparker, @cuishuang, @Frederick888, @dlipovetsky)\n\n## [1.9.1] 2022-08-23\n\n### Added\n\n- Add support for empty string in substitutePath (@RuijieC-dev)\n- Support gnu_debuglink section (@aarzilli)\n- Support exact matches in SubstitutePath (@eandre)\n- Add ability to show disassembly instead of source code (@aarzilli)\n- Add -per-g-hitcount to breakpoint conditions (@yangxikun)\n\n### Fixed\n\n- Ensure breakpoint map exists (@aarzilli)\n- Use standard library to compute CRC for gnu_debuglink section (@aarzilli)\n- Fix command to download Go version in CI (@derekparker)\n- Do not panic reading bad G struct (@aarzilli)\n- Fix parsing DWARFv5 file table (@derekparker)\n- Improve trace subcommand output (@derekparker)\n- Fix documentation for examinemem (@aarzilli)\n- Fix step instruction on 1 byte instruction with software breakpoint (@qmuntal)\n- Fix handling of function entry / return in ebpf tracing backend (@derekparker)\n- Fix size of ebpf type for fn_addr (@derekparker)\n\n### Changed\n\n- Send large terminal output to pager (@aarzilli)\n- Refactor windows backend framework (@qmuntal)\n- Complete the dropping of CGO dependency for ebpf backend (@aarzilli)\n- Limit disassembly range in DAP backend (@aarzilli)\n\n## [1.9.0] 2022-07-06\n\n### Added\n\n- Support for Go 1.19 (#3038, #3031, #3009, @aarzilli)\n- Autocomplete for local variables (#3004, @pippolo84)\n- Support for function call injection on arm64 (#2996, @aarzilli)\n\n### Fixed\n\n- Ctrl-C handling on Windows (#3039, @aarzilli)\n- Expressions accessing maps with string literals (#3036, @aarzilli)\n- Occasional crash caused by race between manual stop and normal stop on macOS (#3021, @aarzilli)\n- Pretty-print of register components (#3022, @aarzilli)\n- Misc function call injection bugs (#3007, #3002, #3000, @aarzilli)\n\n### Changed\n- Improved FreeBSD port (#3019, #2972, #2981, #2982, @4a6f656c)\n- Misc test fixes (#3011, #2995, #2979, @polinasok, @aarzilli)\n- Misc documentation changes (#2998, #2991, @aarzilli, @polinasok)\n- Better autogenerated function skip (#2975, @aarzilli)\n\n## [1.8.3] 2022-04-25\n### Added\n- Pretty-print time.Time variables (@aarzilli)\n- Better \"could not open debug info\" errors (@polinasok)\n- DAP: Support --disable-aslr (@polinasok)\n- DAP interface documentation improvements (@polinasok)\n- CLI documentation improvements (@derekparker, @deathiop)\n\n### Fixed\n- DAP: offer disconnect/stop options for attach mode only (@polinasok)\n- Fix godoc comments (@hitzhangjie)\n- Allow low index == len in reslice expressions (@aarzilli)\n- Fix leaky process when failing to debug stripped binaries in headless mode (@polinasok)\n- Skip stepping into autogenerated functions for go1.18 (@aarzilli)\n\n### Changed\n- Drop support for building on Go < 1.10 (@aarzilli)\n\n## [1.8.2] 2022-03-07\n### Added\n- Add '-clear' option for 'condition' command (@chainhelen)\n- Support ctrl-Z for shell job control (@derekparker)\n\n### Fixed\n- Improve handling of hard coded breakpoints (@aarzilli)\n- Better error messages for ambiguous function calls / type casts (@aarzilli)\n- Fix crash when trying to open separate debug info (@aarzilli)\n- Handle non-install dev tools on osx (@zchee)\n\n### Changed\n- Downgrade loadBuildID error to warning (@aarzilli)\n- Require go-delve/liner in go.mod file instead of upstream version (@hyanhag)\n\n## [1.8.1] 2022-02-07\n\n### Added\n\n- Downloading source code listings with debuginfod (@Foxboron)\n- Added `transcript` command (@aarzilli)\n- Enabled `dump` command on windows (@aarzilli)\n- Env attribute in DAP launch requests (@hyangah)\n- Better documentation for the DAP interface (@polinasok)\n\n### Fixed\n\n- Require argument for trace subcommand (@derekparker)\n- Handling of inlined calls within inlined calls (@derekparker)\n- Handling of DW_AT_inline attribute (@aarzilli)\n- Set stop reason in StepInstruction (@suzmue)\n\n### Changed\n\n- The DAP interface will not create executables in the temp directory (@hyangah)\n- When the `goroutines` command looks for the user frame it will exclude frames in internal and runtime/internal in addition to private runtime functions (@aarzilli)\n- Breakpoints with hitcount conditions are automatically disabled when their condition can no longer be satisfied (@pippolo84)\n- The commands `break` and `trace` will set a breakpoint on the current line if no argument is specified (@thockin)\n- Miscellaneous documentation improvements (@chainhelen, @gareth-rees, @polinasok)\n\n## [1.8.0] 2021-12-23\n\n### Added\n\n* Go 1.18 support\n* Support for DWARF5 on Windows/MacOS (@aarzilli)\n* Added more installation instructions to documentation (@polinasok)\n* Allow for rewind to work after process exit with RR backend (@aarzilli)\n* Added documentation on runtime.curg and runtime.frameoff in eval (@aarzilli)\n* DAP: Expose sources command in evaluate request (@suzmue)\n* DAP: Support Goroutine filters (@suzmue)\n\n### Fixed\n\n* Fix build version using buildinfo (@aarzilli)\n* Fix crash when using deferred with no args (@kaddy-tom)\n* DAP: Misc remote attach improvements (@polinasok)\n\n### Changed\n\n* Misc cleanup and refactoring (@aarzilli)\n* Added option to disable invoking git during build (@herbygillot)\n* Ignore 'pf' mappings during core dump creation (@aarzilli)\n\n## [1.7.3] 2021-11-16\n\n### Added\n\n* Misc changes to prepare for Go 1.18 and generics (#2703, @2745, @aarzilli)\n* Watchpoint support (disabled on Windows) (#2651, #2659, #2667, #2769, @aarzilli)\n* Warn about listening to remote connections (#2721, @aarzilli)\n* Support call injection with rr backend (#2740, @aarzilli)\n* Support JSON-RPC and DAP on the same port from 'dlv debug/exec/test/attach' (#2755, @polinasok)\n* DAP: Remote attach support (#2709, @polinasok)\n* DAP: Multi-client support (#2731, #2737, #2781, @polinasok)\n* DAP: Logpoints support (#2634, #2730, #2747, #2748, @suzmue)\n* DAP: Disassembly view support (#2713, #2716, #2728, #2742, @suzmue)\n* DAP: Support dlvCwd and use a temp file as default debug binary (#2660, #2734, @hyangah, @polinasok)\n* DAP: Auto-resume execution when setting breakpoints while running (#2726, @suzmue)\n* DAP: Add --client-addr flag to run dap with a predefined client (#2568, @hyangah)\n* DAP: Log parsed and applied launch configs (#2732, @polinasok)\n* DAP: Add option to hide system goroutines (#2743, @suzmue)\n* DAP: Add support for special 'config' expressions (#2750, @suzmue)\n\n### Fixed\n\n* Return correct exit status from Halt command (#2674, @suzmue)\n* Merge register data before writing to register (#2699, @mknyszek)\n* Do not assign temp breakpoint IDs to avoid conflicts with user breakpoints (#2650, @aarzilli)\n* Miscellaneous fixes for Windows native backend (#2736, @aarzilli)\n* Return error when assigning between function variables (#2692, @aarzilli)\n* Obey logflags config for LoadConfig warnings (#2701, @aarzilli, @suzmue)\n* Workaround for debugserver register set bug (#2770, @aarzilli)\n* DAP: Fix nil dereference when byte array cannot be converted to string (#2733, @polinasok)\n* DAP: Fix data race for noDebugProcess.ProcessState (#2735, @polinasok)\n\n### Changed\n\n* Refine handling of version-too-old errors (#2684, #2712, @polinasok, @yang-wei)\n* eBPF tracing backend return value parsing (#2704, @derekparker)\n* Replace libbpfgo with cilium/ebpf (##2771, @derekparker)\n* DAP: Merge Arguments and Locals scopes (#2717, @suzmue)\n* DAP: Refine launch/attach error visibility (#2671, @polinasok)\n* DAP: Server refactoring to separate listener and client session layers (#2729, @polinasok)\n* DAP: Improve shutdown logic and test coverage (#2749, @polinasok)\n\n## [1.7.2] 2021-09-21\n\n### Added\n\n* Documentation: Add notes on porting Delve to other architectures (@aarzilli)\n* Add internal checks to ensure we're synched with Go runtime internals (@aarzilli)\n* eBPF backend can parse goroutine info (@derekparker)\n* Add support for debuginfo-find (@derekparker)\n* Add MAKE arguments for GOOS / GOARCH (@cmol)\n\n### Fixed\n\n* Correctly check for 1.17 and regabi (@aarzilli)\n* Print config output strings quoted (@aarzilli, @krobelus)\n* Update check for system goroutines (@suzmue)\n* DAP: Halt before detach in Stop (@polinasok)\n* DAP: Do not send halt request if debuggee is not running (@suzmue)\n\n### Changed\n\n* Include selected goroutine in threads request (@suzmue)\n* Remove individual OS install instructions (@gabriel-vasile)\n* DAP: Show decimal / hex values for uint (@suzmue)\n* Avoid bright colors in default syntax highlighting (@krobelus)\n\n## [1.7.1] 2021-08-18\n\n### Added\n\n- *EXPERIMENTAL* Added support for eBPF based trace backend (@derekparker)\n- Added fuzzy completion for the CLI for commands and breakpoint locations (@derekparker)\n- Added stack watchpoints (@aarzilli)\n- Added verbose version output (@hyangah)\n- DAP: Support for replay and core modes (@Iggomez)\n- DAP: Added ability to page stack frames (@suzmue)\n- DAP: Added len as metadata for maps (@suzmue)\n- DAP: Add 'backend' launch/attach attribute (@polinasok)\n\n### Fixed\n\n- Fix handling of runtime throws (@derekparker)\n- DAP: Handle unexpected debugger termination (@polinasok)\n\n### Changed\n\n- Added configuration for Target to not clear stepping breakpoints (@suzmue)\n- Ignore existing breakpoints for continue-until (@derekparker)\n- Improve help output for examinemem (@derekparker)\n- Clarify next-while-nexting error (@suzmue)\n- DWARF improvements for additional opcodes (@aarzilli)\n- Treat SIGTERM as server disconnect signal (@polinasok)\n- Update Cobra lib to v1.1.3 (@hyangah)\n- Improvements to 'on' command (@aarzilli)\n- Terminal will now prompt when breakpoint is hit during next/step/stepout (@aarzilli)\n- DAP: Ensure server is always headless and target foregrounded (@polinasok)\n- DAP: Set hit breakpoint IDs (@suzmue)\n\n## [1.7.0] 2021-07-19\n\n### Added\n\n- Go 1.17 support (@aarzilli, @mknyszek)\n- Add new API and terminal command for setting watchpoints (@aarzilli)\n- Add filtering and grouping to goroutines command (@aarzilli)\n- Added support for hit count condition on breakpoints (@suzmue, @aarzilli)\n- DAP server: Handle SetVariable requests (@hyangah)\n- DAP server: Add clipboard support (@hyangah)\n\n### Fixed\n\n- DAP server: Several shutdown / disconnect fixes (@suzmue, @polinasok)\n- DAP server: Clean output executable name on Windows (@hyangah)\n- DAP server: Variables response must not have null variables array (@polinasok)\n- Fix runtimeTypeToDIE setup (necessary for Go 1.17) (@aarzilli)\n- Reenable CGO stacktrace test on arm64 (@derekparker)\n- Fix incorrect integer casts in freebsd C backend (@dwagin)\n- Ensure correct exit status reported on commands following process death (@derekparker)\n- Misc flakey test fixes / test refactoring (@polinasok)\n- Fix for frame parameter being ignored in ConvertEvalScope when no goroutine is found (@suzmue)\n- Ensure ContinueOnce returns StopExited if process exited, otherwise return StopUnknown (@polinasok)\n- Fix panic in RPC2.ListDynamicLibraries (@derekparker)\n- Fix typo in flag passed to check if debugserver supports unmask_signals (@staugust)\n\n### Changed\n\n- DAP server: Add sameuser security check (@hyangah)\n- DAP server: Changes to context-dependent load limits for string type (@hyangah, @polinasok)\n- DAP server: Add paging for arrays, slices and maps (@suzmue)\n- DAP server: Deemphasize internal runtime stack frames (@suzmue)\n- DAP server: Add throw reason to exception information upon panic (@suzmue)\n- DAP server: Set breakpoint hit ID (@suzmue)\n- DAP server: Add string value of byte/rune slice as child (@suzmue)\n- Documentation: Add viminspector to list of editor plugins (@aarzilli)\n- Support for ZMM registers in gdbserial backend (@aarzilli)\n- Remove support for stack barriers (@derekparker)\n- Improve support for DWARF5 (@derekparker)\n- Improve documentation (@derekparker, @aarzilli)\n- Print message and exit if Delve detects it is running under Rosetta on M1 macs (@aarzilli)\n- Drop official Go 1.14 support (@derekparker)\n\n## [1.6.1] 2021-05-18\n\n### Added\n\n- Dump command: generate core dumps from within Delve (@aarzilli)\n- Toggle command: toggle breakpoints on or off (@alexsaezm)\n- DAP server improvements (@polinasok, @hyangah, @suzmue)\n- Delve now parses and uses the .eh_frame section when available (@aarzilli)\n- Add linespec argument to 'continue' command (@icholy)\n- Add optional format argument to 'print' and 'display' commands (@aarzilli)\n\n### Fixed\n\n- Fixed file reference handling with DWARF5 compilation units (@thanm)\n- Fix embedded field searching (@aarzilli)\n- Fix off by one error reading core files (@aarzilli)\n- Correctly read G address on linux/arm64\n- Avoid double removal of temp built binary (@polinasok)\n- Fix temp binary deletion race in DAP server (@polinasok)\n- Fix shutdown related bugs in RPC server (@aarzilli)\n- Fix crashes induced by RequestManualStop (@aarzilli)\n- Fix handling of DW_OP_piece (@aarzilli)\n- Correctly truncate the result of binary operations on integers (@aarzilli)\n\n### Changed\n\n- Dropped Go 1.13 support (@aarzilli)\n- Improved documentation (@ChrisHines, @aarzilli, @becheran, @hedenface, @andreimatei, @ehershey , @hyangah)\n- Allow examinememory to use an expression (@felixge)\n- Improve gdb server check on newer ARM based macs (@oxisto)\n- CPU registers can now be used in expressions (@aarzilli)\n- DAP: Add type information to variables (@suzmue)\n- DAP: Support setting breakpoints while target is running (@polinasok)\n- DAP: Implement function breakpoints (@suzmue)\n\n## [1.6.0] 2021-01-28\n\n### Added\n\n- Support for debugging darwin/arm64 (i.e. macOS on Apple Silicon) (#2285, @oxisto)\n- Support for debugging Go1.16 (#2214, @aarzilli)\n- DAP: support for attaching to a local process (#2260, @polinasok)\n- DAP: fill the `evaluateName` field when returning variables, enabling \"Add to Watch\" and \"Copy as Expression\" features of VSCode (#2292, @polinasok)\n- Added WaitSince, WaitReason to `service/api.Goroutine` and to the `goroutines` command (#2264, #2283, #2270, @dlsniper, @nd, @aarzilli)\n- Syntax highlighting for Go code (#2294, @aarzilli)\n- Added flag `CallReturn` to `service/api.Thread` to distinguish return values filled by a `stepOut` command from the ones filled by a `call` command (#2230, @aarzilli)\n\n### Fixed\n\n- Fix occasional \"Access is denied\" error when debugging on Windows (#2281, @nd)\n- Register formatting on ARM64 (#2289, @dujinze)\n- Miscellaneous bug fixes (#2232, #2255, #2280, #2286, #2291, #2309, #2293, @aarzilli, @polinasok, @hitzhangjie)\n\n### Changed\n\n- The `goroutines` command can be interrupted by pressing Ctrl-C (#2278, @aarzilli)\n- Using a TeamCity instance provided by JetBrains for Continuous Integration (#2298, #2307, #2311, #2315, #2326, @artspb, @nd, @aarzilli, @derekparker)\n- Improvements to documentation and error messages (#2266, #2265, #2273, #2299, @andreimatei, @hitzhangjie, @zamai, @polinasok)\n\n## [1.5.1] 2020-12-09\n\n### Added\n- DAP: Scope and variable requests, including call injection (#2111, #2158, #2160, #2184, #2185, @polinasok)\n- DAP: Support removing breakpoints and breakpoint conditions (#2188, @polinasok)\n- DAP: Support next, stepIn, stepOut requests (#2143, @polinasok)\n- DAP: Miscellaneous improvements (#2167, #2186, #2238, #2233, #2248, @eliben, @suzmue, @polinasok)\n- Command line flag `-r` to redirect standard file descriptors of the target process (#2146, #2222, @aarzilli)\n- `-size` flag for `examinemem` command (##2147, @hitzhangjie)\n- Command line flag to disable ASLR (#2202, @aarzilli)\n- Support for DWARFv5 loclists (#2097, @aarzilli)\n\n### Fixed\n- Support for Go version >= 1.15.4 (#2235, @aarzilli)\n- Fix displaying AVX registers (#2139, @aarzilli)\n- Panic during `next`, `step` when there is no current goroutine (#2164, @chainhelen)\n- Reading a deferred call's arguments on linux/arm64 (#2210, @aarzilli)\n- Miscellaneous bug fixes (#2135, #2131, #2142, #2140, #2127, #2113, #2172, #2181, #2195, #2193, #2220, #2179, #2206, #2223, @aarzilli)\n\n### Changed\n- `dlv test` switches to the package directory like `go test` does (#2128, @aarzilli)\n- Delve will no longer resolve symbolic links when searching for split debug_info if the executable path is not /proc/pid/exe (#2170, @aarzilli)\n- Starlark scripts can now be interrupted using Ctrl-C even if they are not making any API calls (#2149, @aarzilli)\n- An error message will be displayed more prominently if a connection is rejected due to the `--only-same-user` flag (which is enabled by default) (#2211, @aarzilli)\n- Substitute path rules are applied to the argument of `break` and `trace` (#2213, @aarzilli)\n- The output of `xcode-select --print-path` will be used to determine the location of `debugserver` instead of a hardcoded path (#2229, @aaronsky)\n- Improvements to documentation and error messages (#2148, #2154, #2196, #2228, @aurkenb, @pohzipohzi, @chainhelen, @andreimatei)\n\n\n## [1.5.0] 2020-07-29\n\n### Added\n\n- Go 1.15 support (#2011, @aarzilli)\n- Added the `reload` command that restarts the debugging session after recompiling the program (#1971, @alexsaezm)\n- Better support for printing pointers in the C part of a cgo program (#1997, @aarzilli)\n- Some support for DWARFv5 (#2090, @aarzilli)\n\n### Fixed\n\n- Fixed trace subcommand when the `-p` option is used (#2069, @chainhelen)\n- Nil pointer dereference when printing tracepoints (#2071, @aarzilli)\n- Internal debugger error when printing the goroutine list of a corrupted or truncated core file (#2070, @aarzilli)\n- Do not corrupt the list of source files whenever a plugin (or dynamically loaded library) is loaded (#2075, @aarzilli)\n- Fixed current file/line reported after a segfault on macOS that was wrong under certain circumstances (#2081, @aarzilli)\n- Internal debugger error when reading global variables of types using unsupported debug_info features (#2105, #2106, #2110, @aarzilli, @b00f)\n\n### Changed\n\n- Support for stack trace requests in DAP and other DAP improvements (#2056, #2093, #2099, #2103, @polinasok)\n- Delve will step inside a private runtime function call when it is already inside the runtime package (#2061, @aarzilli)\n- Updated cosiner/argv dependency to v0.1.0 (#2088, @gadelkareem)\n- Improvements to documentation and error messages (#2068, #2084, #2091, @aarzilli, @bhcleek, @letientai299)\n\n## [1.4.1] 2020-05-22\n\n### Added\n\n- Support for linux/386 added (@chainhelen)\n- DAP server initial release (@polinasok, @eliben, @hyangah)\n- New command `examinemem` (or `x`) allows users to examine raw memory (@chainhelen)\n- New command `display` allows users to print value of an expression every time the program stops (@aarzilli)\n- New flag `--tty` allows users to supply a TTY for the debugged program to use (@derekparker)\n- Coredump support added for Arm64 (@ossdev07)\n- Ability to print goroutine labels (@aarzilli)\n- Allow printing registers for arbitrary stack frames (@aarzilli)\n- Add `disassemble-flavor` to config to specify assembly syntax (@chainhelen)\n\n### Fixed\n\n- Allow function calls on non-struct types (@derekparker)\n- Dwarf line parsing bug fix (@klemens-morgenstern)\n- Improved error message when building Delve on unsupported systems (@aarzilli)\n- Improved error message when trying to execute a binary in an invalid format for host system (@derekparker)\n- Fix panic in Delve when using `call` command with some invalid input (@chainhelen)\n\n### Changed\n\n- Improved output from `dlv trace` and `trace` REPL commands (@derekparker)\n- Conditional breakpoint performance improvements (@aarzilli)\n- Thread register loading performance improvement on gdbserial backend (@derekparker)\n- Reduce default log level to error (@aarzilli)\n- Linux memory read/write optimization using process_vm_read/write (@cuviper)\n- Terminal output of commands divided into categories (@aarzilli)\n- Use less permissive file settings on history file (@derekparker)\n- Autogenerated interface method calls wrappers now automatically stepped through (@aarzilli)\n\n## [1.4.0] 2020-02-11\n\n### Added\n\n- Support for Linux/ARM64 (#1733, #1780 @hengwu0, @tykcd996)\n- Support for Go 1.14 (@aarzilli)\n- Added an API call that can be used by Delve front-ends to map between package names and build paths (#1784, @aarzilli)\n- Added a field to goroutine objects returned by the API listing the goroutine's pprof labels (#1836, @nd)\n- Better support for inlined functions (#1717, #1742, #1807 @aarzilli)\n\n### Fixed\n\n- Fixed target program crash after step-instruction (#1738, @aarzilli)\n- Fixed miscellaneus bugs related to debugging Position Independent Executables and plugins (#1775, @aarzilli)\n- Always remove breakpoints during detach (#1772, @hengwu0)\n- Fixed Delve's exit status after the program has ended (#1781, @derekparker)\n- Fixed nil pointer dereference in FunctionReturnLocations (#1789, @aarzilli)\n- Improved performance of `goroutines -t` command (#1830, @aarzilli)\n- Fixed occasional \"Access Denied\" error during attach on Windows (#1826, @alexbrainman)\n- Fixed parsing of the `disassemble` command (#1837, @chainhelen)\n\n### Changed\n\n- Check that local connections originate from the same User ID as the one that started Delve's instance (#1764, @stapelberg)\n- Mapping between package names and package paths is done using the DW_AT_go_package_name where available (#1757, @aarzilli)\n- Improvements to documentation and error messages (#1806, #1822, #1827, #1843, #1848, #1850, #1853 @spacewander, @chainhelen, @stigok)\n- Miscellaneous code refactorings (#1746, #1777, #1834 @derekparker, @aarzilli)\n\n## [1.3.2] 2019-10-21\n\n### Added\n\n- New example for starlark documentation (@aarzilli)\n- Allow calls to optimized functions (@aarzilli)\n- Option to bypass smart stacktraces (@aarzilli)\n- Ability to call method of embedded field (@chainhelen)\n- Added `make unininstall` command (@chainhelen)\n- User can re-record recorded targets (@aarzilli)\n\n### Fixed\n\n- Fix version reporting (current latest tagged as 1.3.1, reporting 1.3.0) (@derekparker)\n- Fix nil pointer deref on proc.GetG (@aarzilli)\n- Better handling of DW_TAG_inlined_subroutine without debug_line info (@aarzilli)\n- Fix panic on invalid config values (@TerrySolar)\n- Fix debug_line state machine behavior with multi-sequence units (@aarzilli)\n- Fix starlark iteration on maps > 64 entries (@alxn)\n- debug_frame parser fixed parsing augmentation (@chainhelen)\n- Round TLS segment size to its alignment (@heschik)\n\n### Changed\n\n- Documentation bumped required Go version (@codekaup)\n- Disassemble now works without a selected goroutine (@aarzilli)\n- Correctly mark closure variables as shadowed (@aarzilli)\n- Bump CI to use Go 1.13 (@aarzilli)\n\n## [1.3.0] 2019-08-27\n\n### Added\n\n- Go 1.13 support (#1546, @aarzilli)\n- Starlark scripting language in the command line client (#1466, #1605, @aarzilli, @derekparker)\n- Initial support for FreeBSD (#1480, @rayrapetyan)\n- Command line flag to continue process immediately after launch/attach (#1585, @briandealwis)\n- Configuration option for the maximum recursion depth used when printing variables (#1626, @msaf1980)\n- `next` command now takes a numerical option specifying how many times it should be repeated (#1629, @jeremyfaller)\n- Command line options to redirect logs to a file or file descriptor (#1525, @aarzilli)\n- Ability to read goroutine ancestors if they are enabled by passing `GODEBUG=\"tracebackancestors=N\"` (requires Go >= 1.11) (#1514, #1570, @aarzilli)\n- Breakpoint autocompletion for the command line client (#1612, @qingyunha)\n- Added reverse step-instruction command for rr backend (#1596, @dpapastamos)\n- Support debugging programs using plugins on Linux with Go 1.12 or later (#1413, #1414, @aarzilli)\n- Improved function call injection (#1503, #1504, #1548, #1591, #1602, @aarzilli)\n- New variable flag to mark variables that have a fake or no-longer-valid address, because they are either stored in registers or in a stack frame that has been removed from the stack (#1619, @aarzilli)\n- Support relative file paths when specifying breakpoint locations (#1478, @chainhelen)\n- GetVersion API response now reports currently used backend (#1641, @aarzilli)\n- `so` as alias for `stepout` (#1646, @stmuk)\n\n### Fixed\n\n- Fixed values of registers smaller than 64bit (#1583, @derekparker)\n- Fixed reading maps with removed entries in Go 1.12 (#1532, @aarzilli)\n- Fixed possible crash on Linux caused by function call injection (#1538, @aarzilli)\n- Fixed errors reading DWARF sections (#1574, #1582, #1603, @aarzilli)\n- Prompt to shutdown headless instance after the target process has exited (#1621, @briandealwis)\n- Stacktraces when a SIGSEGV (or other signal) happens during a cgo call (#1647, @aarzilli)\n- Error restarting program with next/step/stepout under some circumstances (#1657, @aarzilli)\n- Other bug fixes (#1487, #1488, #1490, #1500, #1497, #1469, #1553, #1595, #1594, #1620, #1622, #1624, #1637, #1664, #1665, #1668, @derekparker, @aarzilli, @dpapastamos, @pjot726)\n\n### Changed\n\n- Delve will refuse to work with a version of Go that is either too old or too new (can be disabled with `--check-go-version=false`) (#1533, @aarzilli)\n- When the value of a variable is determined to be a symbolic constant the numerical value of the symbolic constant will also be printed (#1530, @aarzilli)\n- Catch fatal runtime errors (such as the deadlock detector triggering) automatically (#1502, @aarzilli)\n- Replaced glide (which we weren't using anymore) with `go mod vendor` in make script (#1606, @derekparker)\n- Removed support for reading interfaces in older versions (prior to 1.7) of Go (#1501, @aarzilli)\n- Removed support for location expression \":0\" and associated API functionality (#1588, @aarzilli)\n- Calling an unknown method through the JSON-RPC API will now return an error while previously it would simply be ignored (#1571, @aarzilli)\n- Improved documentation and error messages (#1492, #1520, #1524, #1561, #1562, #1556, #1559, #1567, #1638, #1649, #1662, @derekparker, @Ladicle, @qaisjp, @justinclift, @tschundler, @two, @aarzilli, @dr2chase)\n\n## [1.2.0] 2019-02-19\n\n### Added\n\n- Go 1.12 support\n- Improved `trace` command to show return values and trace pre-built executables or tests (#1379, #1380, #1381, @derekparker)\n- Windows Minidump support (#1386, #1387, #1402, @aarzilli)\n- Better support for split DWARF symbol files (#1405, #1420, @derekparker, @slp)\n- Function call support on macOS (#1324, @derekparker)\n- `deferred` command to view the arguments of a deferred call (#1285, #1265, @aarzilli)\n- Support for debugging Position Independent Executables (#1358, @aarzilli)\n- Type conversions of byte and rune arrays into strings (#1372, @chainhelen)\n- Configuration option (source-list-line-color) to change the color of line numbers in listings (#1364, @Russtopia)\n- New expression `iface.(data)` to access the concrete value of interface variable `iface`, without having to write a full type assertion (#1340, @aarzilli)\n- Support for specifying multiple source files as arguments for `debug`, `trace` and `test` (#1339, @chainhelen)\n\n### Fixed\n\n- Make `edit` command work with vim and neovim (#1451, @the4thamigo-uk)\n- Support Linux kernels prior to 2.6.34 (i.e. without PTRACE_GETREGSET) (#1435, @aarzilli)\n- Fixed `substitute-path` configuration option on Windows (#1418, @zavla)\n- Better performance for ListGoroutines API call (#1440, #1408, @slp, @aarzilli)\n- Better performance when loading the value of very large sparse maps (#1392, @aarzilli)\n- Other bug fixes (#1377, #1384, #1429, #1434, #1445, @aarzilli)\n\n### Changed\n\n- Changes to where the configuration is stored, conforming to [XDG Base Directory Specification](https://specifications.freedesktop.org/basedir-spec/basedir-spec-latest.html) with fallbacks to the current directory when calls to `user.Current` fail (#1455 @GregorioMartinez, @acshekhara1)\n- Project moved from github.com/derekparker/delve to github.com/go-delve/delve (@derekparker)\n- Switched dependency management to go.mod (@aarzilli, @derekparker, @zavla)\n- New build scripts and support building on macOS without the native backend (@aarzilli, @kevin-cantwell)\n- Tolerate corrupted memory when reading the goroutine list (#1354, @aarzilli)\n- Improved documentation and error messages (@sbromberger, @aarzilli, @derekparker, @chainhelen, @dishmaev, @altimac)\n\n## [1.1.0] 2018-08-15\n\n### Added\n\n- Go 1.11 support (@aarzilli)\n- Improvements to Delve logging (@aarzilli, @derekparker)\n- Show global variables in disassembly (@aarzilli)\n- Support for inlined calls (@aarzilli, @derekparker, @jaym)\n- Support dwz compressed debug symbols (@slp)\n- Support for debug info in a separate file (@slp)\n- Let target process access the tty when running in headless mode on linux/native and darwin/gdbserial (@aarzilli)\n- Commands `up` and `down` (@yasushi-saito)\n- Flag to print stacktrace of all goroutines (@acshekhara1)\n- Command `edit` (@benc153)\n- Allow headless instances to keep running without a connected client (@aarzilli)\n- Add `StartLoc` to `api.Goroutine` containing the starting location of each goroutine (@aarzilli)\n- Preliminary support for function call injection with Go 1.11 (@aarzilli)\n- Ability to read list of deferred calls of a goroutine (@aarzilli)\n\n### Fixed\n\n- Fixed crashes when configuration file can not be created (@derekparker, @yuval-k, @aarzilli)\n- Fixed reported location of the go statement of goroutines (@derekparker)\n- Allow evaluation of constants specified without the full package path (@aarzilli)\n- Fixed some integer arithmetic bugs in proc (@functionary)\n- Respect load configuration after reslicing a map (@aarzilli)\n- Fixed race condition between Halt and process death in the linux native backend (@aarzilli)\n- Support core files generated by gdb (@psanford)\n- Fixed evaluation of breakpoint conditions containing a single boolean variable (@aarzilli)\n- Miscellaneous bugs in the debug_line state machine (@aarzilli)\n\n### Changed\n\n- Removed redundant/obsolete methods of proc.Process Halt and Kill, general cleanup of native backends (@aarzilli)\n- Improved documentation (@giuscri, @jsoref, @Carpetsmoker, @PatrickSchuster, @aarzilli, @derekparker, @ramya-rao-a, @dlsniper)\n- Workaround in the gdbserial backend for broken version 902 of debugserver (@aarzilli)\n- Changed operators || and && to short-circuit the evaluation of their arguments, like in Go (@aarzilli)\n- Mark shadowed arguments as shadowed (@aarzilli)\n- Allow syntax \"package/path\".varname to specify the full package path of a variable, in case disambiguating between multiple packages with the same name is necessary (@aarzilli)\n\n## [1.0.0] 2018-02-19\n\n### Added\n\n- Print DWARF location expression with `whatis` (@aarzilli)\n- Use `DW_AT_producer` to warn about optimized code (@aarzilli)\n- Use constants to describe variable value (@aarzilli)\n- Use `DW_AT_decl_line` to determine variable visibility (@aarzilli)\n- `-offsets` flag for `stack` command (@aarzilli)\n- Support CGO stacktraces (@aarzilli)\n- Disable optimizations in C compiler (@aarzilli)\n- `--output` flag to configure output binary (@Carpetsmoker)\n- Support `DW_OP_piece`, `DW_OP_regX`, `DW_OP_fbreg` (@aarzilli)\n- Support `DW_LNE_define_file` (@aarzilli)\n- Support more type casts (@aarzilli)\n\n### Fixed\n\n- Disable file path case normalization on OSX (@aarzilli)\n- Support Mozilla RR 5.1.0 (@aarzilli)\n- Terminal no longer crashes when process exits during `next` (@aarzilli)\n- Fix TestCoreFPRegisters on Go 1.9 (@aarzilli)\n- Avoid scanning system stack if it's not executing CGO (@aarzilli)\n- Locspec \"+0\" should always evaluate to the current PC (@aarzilli)\n- Handle `DW_LNE_end_of_sequence` correctly (@aarzilli)\n- Top level interface variables may have 0 address (@aarzilli)\n- Handle `DW_TAG_subprogram` with a nochildren abbrev (@aarzilli)\n- StepBreakpoint handling (@aarzilli)\n\n### Changed\n\n- Documentation improvements (@grahamking)\n- Removed limitation of exit notifications (@dlsniper)\n- Use `go env GOPATH` for install path\n- Disable test caching (@aarzilli)\n- Disable `-a` and use `all=` for Go 1.10 building (@aarzilli)\n- Automatically deref interfaces on member access (@aarzilli)\n- Replace all uses of `gosymtab/gopclntab` with `.debug_line` section (@aarzilli)\n\n## [1.0.0-rc.2] 2017-10-16\n\n### Added\n\n- Automatically print panic reason for unrecovered panics (@aarzilli)\n- Propagate frame offset to clients (@aarzilli)\n- Added vim-delve plugin to documentation (@sebdah)\n- Floating point register support in core files (@aarzilli)\n- Go 1.9 support, including lexical block support (@aarzilli)\n- Added whatis and config commands (@aarzilli)\n- Add FrameOffset field to api.Stackframe (@aarzilli)\n\n### Fixed\n\n- Better interoperation with debugserver on macOS (@aarzilli / @dlsniper)\n- Fix behavior of next, step and stepout with recursive functions (@aarzilli)\n- Parsing of maps with zero sized values (@aarzilli)\n- Typo in the documentation of `types` command (@custa)\n- Data races in tests (@aarzilli)\n- Fixed SetBreakpoint in native and gdbserial to return the breakpoint if it already exists (@dlsniper)\n- Return breakpoint if it already exists (@dlsniper)\n- Collect breakpoint information on exit from next/stepout/step (@aarzilli)\n- Fixed install instructions (@jacobvanorder)\n- Make headless server quit when the client disconnects (@aarzilli)\n- Store the correct concrete value for interface variables (previously we would always have a pointer type, even when the concrete value was not a pointer) (@aarzilli)\n- Fix interface and slice equality with nil (@aarzilli)\n- Fix file:line location specs when relative paths are in .debug_line (@hyangah)\n- Fix behavior of next/step/stepout in several edge-cases (invalid return addresses, no current goroutine, after process exists, inside unknown code, inside assembly files) (@aarzilli)\n- Make sure the debugged executable we generated is deleted after exit (@alexbrainman)\n- Make sure rr trace directories are deleted when we delete the executable and after tests (@aarzilli)\n- Return errors for commands sent after the target process exited instead of panicking (@derekparker)\n- Fixed typo in clear-checkpoint documentation (@iamzhout)\n\n### Changed\n\n- Switched from godeps to glide (@derekparker)\n- Better performance of linux native backend (@aarzilli)\n- Collect breakpoints information if necessary after a next, step or stepout command (@aarzilli)\n- Autodereference escaped variables (@aarzilli)\n- Use runtime.tlsg to determine G struct offset (@heschik)\n- Use os.StartProcess to implement Launch on windows (@alexbrainman)\n- Escaped variables are dereferenced instead of being reported as &v (@aarzilli)\n- Report errors when we fail to load the executable on attach (@aarzilli)\n- Distinguish between nil and empty slices and maps both in the API and on the command line interface (@aarzilli)\n- Skip deferred functions on next and stepout (as long as they are not called through a panic) (@aarzilli)\n\n## [1.0.0-rc.1] 2017-05-05\n\n### Added\n\n- Added support for core files (@heschik)\n- Added support for lldb-server and debugserver as backend, using debugserver by default on macOS (@aarzilli)\n- Added support for Mozilla RR as backend (@aarzilli)\n\n### Fixed\n\n- Detach should correctly kill child process we created (@aarzilli)\n- Correctly return error when reading/writing memory of exited process (@aarzilli)\n- Fix race condition in test (@hyangah)\n- Fix version extraction to support proposals (@allada)\n- Tolerate spaces better after command prefixes (@aarzilli)\n\n### Changed\n\n- Updated Mac OSX install instructions (@aarzilli)\n- Refactor of core code in proc (@aarzilli)\n- Improve list command (@aarzilli)\n\n## [0.12.2] 2017-04-13\n\n### Fixed\n\n- Fix infinite recursion with pointer loop (@aarzilli)\n- Windows: Handle delayed events (@aarzilli)\n- Fix Println call to be Printf (@derekparker)\n- Fix build on OSX (@koichi)\n- Mark malformed maps as unreadable instead of panicking (@aarzilli)\n- Fixed broken benchmarks (@derekparker)\n- Improve reliability of certain tests (@aarzilli)\n\n### Added\n\n- Go 1.8 Compatibility (@aarzilli)\n- Add Go 1.8 to test matrix (@derekparker)\n- Support NaN/Inf float values (@aarzilli)\n- Handle absence of stack barriers in Go 1.9 (@drchase)\n- Add gdlv to list of alternative UIs (@aarzilli)\n\n### Changed\n\n- Optimized 'trace' functionality (@aarzilli)\n- Internal refactoring to support multiple backends, core dumps, and more (@aarzilli) [Still ongoing]\n- Improve stacktraces (@aarzilli)\n- Improved documentation for passing flags to debugged process (@njason)\n\n## [0.12.1] 2017-01-11\n\n### Fixed\n\n- Fixed version output format.\n\n## [0.12.0] 2017-01-11\n\n### Added\n\n- Added support for OSX 10.12.1 kernel update (@aarzilli)\n- Added flag to set working directory (#650) (@rustyrobot)\n- Added stepout command (@aarzilli)\n- Implemented \"attach\" on Windows (@alexbrainman)\n- Implemented next / step / step-instruction on parked goroutines (@aarzilli)\n- Added support for App Engine (@dbenque)\n- Go 1.7 support\n- Added HomeBrew formula for installing on OSX.\n- Delve now will break on unrecovered panics. (@aarzilli)\n- Headless server can serve multiple clients.\n- Conditional breakpoints have been implemented. (@aarzilli)\n- Disassemble command has been implemented. (@aarzilli)\n- Much improved documentation (still a ways to go).\n\n### Changed\n\n- Pretty printing: type of elements of interface slices are printed.\n- Improvements in internal operation of \"step\" command.\n- Allow quoting in build flags argument.\n- \"h\" as alias for \"help\" command. (@stmuk)\n\n### Fixed\n\n- Improved prologue detection for large stack frames (#690) (@aarzilli)\n- Fixed bugs involving stale executables during restart (#689) (@aarzilli)\n- Various improvements to variable evaluation code (@aarzilli)\n- Fix bug reading process comm name (@ggndnn)\n- Add better detection for launching non executable files. (@aarzilli)\n- Fix halt bug during tracing. (@aarzilli)\n- Do not use escape codes on Windows when unsupported (@alexbrainman)\n- Fixed path lookup logic on Windows. (@lukehoban)\n\n## [0.11.0-alpha] 2016-01-26\n\n### Added\n\n- Windows support landed in master. Still work to be done, but 95% the way there. (@lukehoban)\n- `step-instruction` command added, has same behavior of the old `step` command.\n- (Backend) Implementation for conditional breakpoints, front end command coming soon. (@aarzilli)\n- Implement expression evaluator, can now execute commands like `print i == 2`. (@aarzilli)\n\n### Changed\n\n- `step` command no longer steps single instruction but goes to next source line, stepping into functions.\n- Refactor of `parseG` command for clarity and speed improvements.\n- Optimize reading from target process memory with cache. (prefetch + parse) (@aarzilli)\n- Shorten file paths in `trace` output.\n- Added Git SHA to version output.\n- Support function spec with partial package paths. (@aarzilli)\n- Bunch of misc variable evaluation fixes (@aarzilli)\n\n### Fixed\n\n- Misc fixes in preparation for Go 1.6. (@aarzilli, @derekparker)\n- Replace stdlib debug/dwarf with golang.org/x/debug/dwarf and fix Dwarf endian related parsing issues. (@aarzilli)\n- Fix `goroutines` not working without an argument. (@aarzilli)\n- Always clear temp breakpoints, even if normal breakpoint is hit. (@aarzilli)\n- Infinite loading loop through maps. (@aarzilli)\n- Fix OSX issues related to CGO memory corruption (array overrun in CGO). (@aarzilli)\n- Fix OSX issue related to reporting multiple breakpoints hit at same time. (@aarzilli)\n- Fix panic when using the `trace` subcommand.\n\n## [0.10.0-alpha] 2015-10-04\n\n### Added\n\n- `set` command, allows user to set variable (currently only supports pointers / numeric values) (@aarzilli)\n- All deps are vendored with Godeps and leveraging GO15VENDOREXPERIMENT\n- `source` command and `--init` flag to run commands from a file (@aarzilli)\n- `clearall` commands now take linespec (@kostya-sh)\n- Support for multiple levels of struct nesting during variable eval (i.e. `print foo.bar.baz` now works) (@lukehoban)\n\n### Changed\n\n- Removed hardware assisted breakpoints (for now)\n- Remove Go 1.4.2 on Travis builds\n\n### Fixed\n\n- Limit string sizes, be more tolerant of uninitialized memory (@aarzilli)\n- `make` commands fixed for >= Go 1.5 on OSX\n- Fixed bug where process would not be killed upon detach (@aarzilli)\n- Fixed bug trying to detach/kill process that has already exited (@aarzilli)\n- Support for \"dumb\" terminals (@dlsniper)\n- Fix bug setting breakpoints at chanRecvAddrs (@aarzilli)\n\n## [0.9.0-alpha] 2015-09-19\n\n### Added\n\n- Basic tab completion to terminal UI (@icholy)\n- Added `-full` flag to stack command, prints local vars and function args (@aarzilli)\n\n### Changed\n\n- Output of threads and goroutines sorted by ID (@icholy)\n- Performance improvement: cache parsed goroutines during halt (@icholy)\n- Stack command no longer takes goroutine ID. Use scope prefix command instead (i.e. `goroutine bt`)\n\n### Fixed\n\n- OSX: Fix hang when 'next'ing through highly parallel programs\n- Absolute path confused as regexp in FindLocation (@aarzilli)\n- Use sched.pc instead of gopc for goroutine location\n- Exclude dead goroutines from `goroutines` command output (@icholy)\n\n## [0.8.1-alpha] 2015-09-05\n\n### Fixed\n- OSX: Fix error setting breakpoint upon Delve startup.\n\n## [0.8.0-alpha] 2015-09-05\n\n### Added\n- New command: 'frame'. Accepts a frame number and a command to execute in the context of that frame. (@aarzilli)\n- New command: 'goroutine'. Accepts goroutine ID and optionally a command to execute within the context of that goroutine. (@aarzilli)\n- New subcommand: 'exec'. Allows user to debug existing binary.\n- Add config file and add config options for command aliases. (@tylerb)\n\n### Changed\n- Add Go 1.5 to travis list.\n- Stop shortening file paths from API, shorten instead in terminal UI.\n- Implemented several improvements for `next`ing through highly parallel programs.\n- Visually align registers. (@paulsmith)\n\n### Fixed\n- Fixed output of 'goroutines' command.\n- Stopped preserving temp breakpoints on restart.\n- Added support for parsing multiple DWARF file tables. (@Omie)\n\n## [0.7.0-alpha] 2015-08-14\n\n### Added\n\n- New command: 'list' (alias: 'ls'). Allows you to list the source code of either your current location, or a location that you describe via: file:line, line number (in current file), +/- offset or /regexp/. (@joeshaw)\n- Added Travis-CI for continuous integration. Works for now, will eventually change.\n- Ability to connect to headless server. When running Delve in headless mode (used previously only for editor integration), you now have the opportunity to connect to it from the command line with `dlv connect [addr]`. This will allow you to (insecurely) remotely debug an application. (@tylerb)\n- Support for printing complex numeric types. (@ebfe)\n\n### Changed\n\n- Deprecate 'run' subcommand in favor of 'debug'. The 'run' subcommand now simply prints a warning, instructing the user to use the 'debug' command instead.\n- All 'info' subcommands have been promoted to the top level. You can now simply run 'funcs', or 'sources' instead of 'info funcs', etc...\n- Any command taking a location expression (i.e. break/trace/list) now support an updated linespec implementation. This allows you to describe the location you would like a breakpoint (etc..) set at in a more convenient way (@aarzilli).\n\n### Fixed\n\n- Improved support for CGO. (@aarzilli)\n- Support for upcoming Go 1.5.\n- Improve handling of soft signals on Darwin.\n- EvalVariable evaluates package variables. (@aarzilli)\n- Restart command now preserves breakpoints previously set.\n- Track recurse level when eval'ing slices/arrays. (@aarzilli)\n- Fix bad format string in cmd/dlv. (@moshee)\n" }, { "path": "CLAUDE.md", "content": "# CLAUDE.md\n\nThis file provides guidance to Claude Code (claude.ai/code) when working\nwith code in this repository.\n\n## Project Overview\n\nDelve is a debugger for the Go programming language. This is a complex,\nmulti-layered system that requires understanding of debugging internals,\nDWARF format, OS-specific process control, and Go runtime internals.\n\n## Build and Test Commands\n\n### Building\n\n```bash\nmake build # Build dlv binary\nmake install # Install dlv to system\nmake uninstall # Remove dlv from system\n```\n\n### Testing\n\n```bash\nmake test # Run all tests with vetting\nmake vet # Run Go vet with architecture tags\ngo test -run TestName ./pkg/... # Run specific test by name\ngo test ./pkg/proc # Run all pkg/proc tests\ngo test ./service/test # Run all integration tests\n```\n\n### eBPF Backend Development\n\n```bash\nmake build-ebpf-image # Build Docker image for eBPF compilation\nmake build-ebpf-object # Compile eBPF C code to object files\n```\n\nThe eBPF backend uses Docker to compile C code\n(`pkg/proc/internal/ebpf/bpf/trace.bpf.c`) in a controlled environment,\nproducing architecture-specific `.o` files.\n\n#### eBPF Testing\n\neBPF tests (TestTraceEBPF*) require elevated capabilities (CAP_BPF,\nCAP_PERFMON, CAP_SYS_RESOURCE) and must be run with sudo:\n\n```bash\n# Run specific eBPF test\nsudo go test -v -run TestTraceEBPF3 -count 1 ./cmd/dlv\n\n# Run all eBPF tests\nsudo go test -v -run TestTraceEBPF -count 1 ./cmd/dlv\n\n# Run eBPF tests in Docker (useful when host lacks capabilities or for CI)\ndocker run --privileged -v \"$(pwd)\":/delve -w /delve \\\n -e GOFLAGS=\"-buildvcs=false\" golang:1.24-bookworm \\\n go test -v -run TestTraceEBPF -count 1 ./cmd/dlv\n\n# Suppress debug output\nsudo go test -v -run TestTraceEBPF3 -count 1 ./cmd/dlv 2>&1 | \\\n grep -v \"^DEBUG\"\n```\n\n### Running Delve\n\n```bash\ndlv debug # Compile and debug current package\ndlv test # Compile and debug tests\ndlv attach # Attach to running process\ndlv exec # Debug pre-compiled binary\ndlv dap # Start Debug Adapter Protocol server\n```\n\n## Test-Driven Development (MANDATORY)\n\n**CRITICAL**: All code changes MUST follow test-driven development (TDD).\nThis is not optional.\n\n### Red-Green-Refactor Cycle\n\n1. **RED** - Write a failing test first (must fail for the right reason)\n2. **GREEN** - Write minimum code to pass the test\n3. **REFACTOR** - Clean up while keeping tests green\n4. **VERIFY** - Run full test suite before committing\n\n### Mandatory TDD Rules\n\n1. **NEVER write implementation code without a failing test first**\n2. **NEVER commit code without tests**\n3. **NEVER skip tests or mark them as skipped to make CI pass**\n4. **NEVER disable existing tests** - fix them or fix the code\n5. Each test should verify ONE specific behavior\n6. Test names should describe the scenario being tested\n\n### Example Workflow\n\n```bash\n# RED - Write failing test\ngo test -run TestEvaluateComplexType ./pkg/proc\n# Output: FAIL - undefined: evaluateComplexType (EXPECTED)\n\n# GREEN - Implement minimum code\ngo test -run TestEvaluateComplexType ./pkg/proc\n# Output: PASS\n\n# REFACTOR - Clean up\ngo test -run TestEvaluateComplexType ./pkg/proc\n# Output: PASS (must stay green)\n\n# VERIFY - Full suite\nmake test\n```\n\n### Where to Write Tests\n\n- **Unit tests**: Co-locate with code (e.g., `pkg/proc/variables_test.go`\n for `variables.go`)\n- **Integration tests**: `service/test/` for end-to-end scenarios\n- **Platform-specific tests**: Use build tags (e.g., `//go:build linux`)\n- **Backend-specific tests**: Test each backend separately\n- **Test fixtures**: Source code in `_fixtures/` (compiled during tests,\n not pre-compiled binaries)\n- **Finding fixtures directory**: Use `protest.FindFixturesDir()` from\n `github.com/go-delve/delve/pkg/proc/test` instead of writing custom\n fixture directory lookup code\n\n### Test Quality Standards\n\n- Test behavior, not implementation\n- One assertion per test when possible (easier diagnosis)\n- Clear naming: `Test__`\n- Use existing test utilities in `*_test.go` files\n- Tests must be deterministic (no random values or race conditions)\n\n### When TDD Seems Difficult\n\nDifficulty writing tests first indicates: (1) function doing too much,\n(2) tightly coupled dependencies, or (3) unclear requirements. **DO NOT\nskip TDD** - the difficulty signals a design problem.\n\n## Architecture Overview\n\nDelve uses a **layered architecture** with clear separation of concerns:\n\n```\nCLI (cmd/dlv) → Cobra commands\n ↓\nService Layer (service/) → RPC2, DAP protocol implementations\n ↓\nDebugger (service/debugger) → High-level debugging operations\n ↓\nProcess Abstraction (pkg/proc) → TargetGroup, Target, ProcessInternal\n ↓\nBackend Implementations:\n - pkg/proc/native/ → Direct OS debugging (ptrace, Windows APIs)\n - pkg/proc/gdbserial/ → GDB remote protocol client\n - pkg/proc/core/ → Core dump analysis\n - pkg/proc/internal/ebpf/ → eBPF-based tracing (non-stop debugging)\n```\n\n### Process Abstraction (`pkg/proc`)\n\nCore of Delve's architecture with **two-level interface design**:\n\n- `Process` - Read-only public interface\n- `ProcessInternal` - Internal interface with state-modifying operations\n- `Target` - Wraps `ProcessInternal` with debugging state\n- `TargetGroup` - Manages multiple processes (for exec following)\n- `Thread` - OS thread abstraction\n- `MemoryReadWriter` - Memory access abstraction\n\nBackends are pluggable via `ProcessInternal` interface. When modifying\nbackends, changes usually apply to ALL implementations.\n\n### Service Layer (`service/`)\n\n- **`debugger/`** - `Debugger` struct wrapping `TargetGroup` with\n high-level operations (launch, attach, breakpoints, stepping, variable\n evaluation)\n- **`rpc2/`** - JSON-RPC 2.0 server for remote clients\n- **`dap/`** - Debug Adapter Protocol for IDE integration\n- **`api/`** - Shared type definitions\n\n### Binary Analysis\n\n- **`pkg/dwarf/`** - Custom DWARF parser with Delve-specific features\n- **`pkg/gobuild/`** - Go build system integration\n- **`pkg/proc/BinaryInfo`** - Debug symbols, function entries, line tables\n\n### Platform/Architecture Handling\n\nUses **filename-based conditional compilation**:\n\n- OS-specific: `*_linux.go`, `*_darwin.go`, `*_windows.go`, `*_freebsd.go`\n- Architecture-specific: `regs_amd64.go`, `regs_arm64.go`, etc.\n- **DO NOT put platform-specific code in generic files**\n- In most cases platform-specific code should only be added to the\n `pkg/proc/native` and `pkg/proc/gdbserial` backends.\n\nSupported: amd64, arm64, 386, ppc64le, riscv64, loong64\n\n## Development Guidelines\n\n### Code Organization\n\n1. **OS/arch separation**: Use Go's filename-based conditional\n compilation. Never put platform-specific code in generic files.\n\n2. **Breakpoint types**: Two kinds exist:\n - `LogicalBreakpoint` - User-visible (set at file:line or function)\n - `Breakpoint` - Physical per target (multiple per logical breakpoint)\n\n3. **Testing**: See \"Test-Driven Development (MANDATORY)\" section above.\n\n### Working with DWARF\n\n- Parsing in `pkg/dwarf/` with custom reader utilities\n- Operations (expressions) in `pkg/dwarf/op/`\n- Variable evaluation issues: check type reading\n (`pkg/proc/variables.go`), DWARF expression evaluation\n (`pkg/dwarf/op/`), and memory reading (`Process.Memory()`)\n\n### Working with eBPF Backend\n\n`pkg/proc/internal/ebpf/` is **fundamentally different**: uses **uprobes**\nto trace function calls without stopping execution. C code compiles to\neBPF bytecode using Docker for reproducible builds. Manages goroutines for\nevent processing - be careful with shutdown.\n\nModifying eBPF code:\n\n1. Edit `pkg/proc/internal/ebpf/bpf/trace.bpf.c`\n2. Run `make build-ebpf-object`\n3. Go code loads `.o` files using cilium/ebpf library\n\n**Critical - Function Prologues**: Set breakpoints/uprobes at\n`FirstPCAfterPrologue`, not `fn.Entry` (unless explicitly requested). Go's\nstack-check prologue will re-trigger if set at `fn.Entry`.\n\n### Commit Message Format\n\nUse subsystem-based format from CONTRIBUTING.md:\n\n```\n: \n\n\n\nFixes #\n```\n\nSubsystems: `proc`, `service`, `terminal`, `dwarf`, `native`, `dap`, `rpc2`,\n`cmd/dlv`, etc.\n\n**Subject line**: Max 70 characters, **Body**: Wrap at 80 characters\n\n**Example**:\n\n```\nproc/internal/ebpf: fix goroutine leak and shutdown sequence\n\nThe eBPF event processing goroutines were not being properly cleaned up\non debugger shutdown, causing resource leaks. This adds proper context\ncancellation and wait groups.\n\nFixes #1234\n```\n\n### Common Pitfalls\n\n1. **Don't modify Process state directly** - Use `ProcessInternal` methods\n for locking and state consistency\n\n2. **Breakpoint insertion is backend-specific** - `native` uses software\n breakpoints (INT3), `gdbserial` sends packets, `ebpf` uses uprobes\n\n3. **Thread vs Goroutine** - Delve tracks both OS threads (`Thread`) and\n Go goroutines (`G` struct). Most operations work on goroutines, not\n threads.\n\n4. **Memory safety** - Always handle errors when reading process memory.\n Process may die, memory may be unmapped, or addresses invalid.\n\n5. **Don't reparse DWARF sections** - `loadDebugInfoMaps` already\n iterates all compile units. Add per-CU checks there instead of\n making separate passes over `debug_info`.\n\n## File Organization\n\n```\ndelve/\n├── cmd/dlv/ # CLI entry point and commands\n├── pkg/\n│ ├── proc/ # Core process abstraction\n│ │ ├── native/ # OS-level debugging backends\n│ │ ├── gdbserial/ # GDB remote protocol\n│ │ ├── core/ # Core dump support\n│ │ ├── internal/ebpf/ # eBPF tracing backend\n│ │ └── *.go # Process interfaces and common logic\n│ ├── dwarf/ # DWARF parsing and manipulation\n│ ├── terminal/ # Interactive CLI\n│ ├── config/ # Configuration (.delverc)\n│ └── ... # Other utilities\n├── service/\n│ ├── debugger/ # High-level debugger API\n│ ├── rpc2/ # JSON-RPC 2.0 server\n│ ├── dap/ # Debug Adapter Protocol\n│ └── api/ # Shared type definitions\n├── _fixtures/ # Test source files (compiled during tests)\n├── _scripts/ # Build helper scripts\n└── Documentation/ # User and internal documentation\n```\n\n## Dependencies\n\nKey external dependencies (see `go.mod`):\n\n- `github.com/cilium/ebpf` - eBPF program loading\n- `github.com/google/go-dap` - Debug Adapter Protocol\n- `github.com/spf13/cobra` - CLI framework\n- `golang.org/x/arch` - CPU architecture utilities\n- `golang.org/x/sys` - System calls and OS interfaces\n\n## Resources\n\n- [Internal Architecture Slides](https://speakerdeck.com/aarzilli/internal-architecture-of-delve)\n- [Porting Guide](Documentation/internal/portnotes.md)\n- [API Documentation](Documentation/api)\n- [How to Write a Delve Client](Documentation/api/ClientHowto.md)\n" }, { "path": "CONTRIBUTING.md", "content": "# Contributing to Delve\n\nWant to help contribute to Delve? Great! Any and all help is certainly appreciated, whether it's code, documentation, or spelling corrections.\n\nIf you are planning to contribute a significant change, please draft a design document (or start a conversation) and post it to the [developer mailing list](https://groups.google.com/forum/#!forum/delve-dev). This will allow other developers and users to discuss the proposed change.\n\n## Filing issues\n\nWhen filing an issue, make sure to answer these six questions:\n\n1. What version of Delve are you using (`dlv version`)?\n2. What version of Go are you using? (`go version`)?\n3. What operating system and processor architecture are you using?\n4. What did you do?\n5. What did you expect to see?\n6. What did you see instead?\n\n## Contributing code\n\nFork this repo and create your own feature branch. Install all dependencies as documented in the README.\n\n### Build prerequisites\n\n- Go (see `go.mod` for minimum version)\n- [goreleaser v2](https://goreleaser.com/install/) — required for `make build`\n Install: `go install github.com/goreleaser/goreleaser/v2@latest`\n\n### Guidelines\n\nConsider the following guidelines when preparing to submit a patch:\n\n* Follow standard Go conventions (document any new exported types, funcs, etc.., ensuring proper punctuation).\n* Ensure that you test your code. Any patches sent in for new / fixed functionality must include tests in order to be merged into master.\n* If you plan on making any major changes, create an issue before sending a patch. This will allow for proper discussion beforehand.\n* Keep any os / arch specific code contained to os / arch specific files. Delve leverages Go's filename based conditional compilation, i.e do not put Linux specific functionality in a non Linux specific file.\n\n### Format of the Commit Message\n\nWe follow a rough convention for commit messages that is designed to answer two\nquestions: what changed and why. The subject line should feature the what and\nthe body of the commit should describe the why.\n\n```\nterminal/command: Add 'list' command\n\nThis change adds the 'list' command which will print either your current\nlocation, or the location that you specify using the Delve linespec.\n\nFixes #38\n```\n\nThe format can be described more formally as follows:\n\n```\n: \n\n\n\n