Skip to content

cmd: add LLGo-aware LLDB launcher - #2205

Closed
cpunion wants to merge 9 commits into
xgo-dev:mainfrom
cpunion:codex/llgo-lldb-integration-20260729
Closed

cmd: add LLGo-aware LLDB launcher#2205
cpunion wants to merge 9 commits into
xgo-dev:mainfrom
cpunion:codex/llgo-lldb-integration-20260729

Conversation

@cpunion

@cpunion cpunion commented Jul 28, 2026

Copy link
Copy Markdown
Collaborator

Summary

Stock LLDB no longer has a maintained Go language plugin, and upstream requires
an RFC plus a committed long-term maintainer before restoring one. Keep the
LLGo-specific integration in this repository:

  • add llgo lldb, which embeds and loads the LLGo Python adapter without
    depending on a source checkout;
  • support LLDB 18+ auto-detection, LLGO_LLDB, -lldb, and LLDB argument
    pass-through;
  • keep one plugin source and make the existing shell launcher a compatibility
    wrapper;
  • keep adapter commands under the llgo namespace so stock LLDB p and v
    remain unchanged;
  • keep the flat acceptance fixture under cmd/llgo/lldbtest, with source-line
    markers and explicit Python SB API assertions instead of comment parsing;
  • run the complete LLDB acceptance suite through llgo lldb on the primary
    macOS and Ubuntu jobs.

This does not change LLGo's current DWARF contract: compile units remain
DW_LANG_C for stock-LLDB variable visibility, while the LLGo producer and
versioned marker select the external adapter. The test suite also verifies that
an ordinary C binary is not identified as LLGo.

Testing

  • macOS arm64, Apple LLDB 1703: 198/198 real breakpoint, scope, type, and value
    checks
  • Ubuntu amd64, LLDB 19: 198/198 checks
  • Linux arm64, LLDB 19.1.7: 198/198 checks
  • cmd/internal/lldb statement coverage: 83.9% on both platforms
  • go test -vet=off -timeout 30m ./...
  • Linux: go test ./cmd/llgo and go build ./...

Refs #2154. Follow-ups #2206 and #2211.

@codecov

codecov Bot commented Jul 28, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

@cpunion
cpunion force-pushed the codex/llgo-lldb-integration-20260729 branch from f5b2ddf to ca99801 Compare July 28, 2026 23:15
@cpunion
cpunion force-pushed the codex/llgo-lldb-integration-20260729 branch from 15fd215 to 223db02 Compare July 29, 2026 00:58
@cpunion

cpunion commented Jul 29, 2026

Copy link
Copy Markdown
Collaborator Author

Superseded by #2211, which retains the launcher and acceptance-suite commits and adds the versioned marker/schema contract. Keeping one standalone PR avoids an unnecessary merge dependency.

@cpunion cpunion closed this Jul 29, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant