Skip to content

update: clarify LLDB breakpoint behavior with Mojo JIT compilation#229

Merged
ehsanmok merged 1 commit intomodular:mainfrom
Bakobiibizo:update-p09-docs
Mar 27, 2026
Merged

update: clarify LLDB breakpoint behavior with Mojo JIT compilation#229
ehsanmok merged 1 commit intomodular:mainfrom
Bakobiibizo:update-p09-docs

Conversation

@Bakobiibizo
Copy link
Copy Markdown
Contributor

This PR addresses issue #228 and clarifies breakpoint behavior in the debugging tutorial when using LLDB with Mojo programs. The current tutorial implies the breakpoint should resolve immediately, which can make the warning message look like an error when it shows the breakpoint being set . Which can be confusing for readers because it appears as though the breakpoint failed, even though it resolves automatically once the program begins execution and the module is compiled.

essentials.md

  • Document that pending breakpoints are expected when debugging JIT-compiled Mojo programs
  • Explain that LLDB registers the breakpoint but cannot bind it to an address until execution begins
  • Clarify that the breakpoint resolves automatically after the program starts running

This was encountered while following the GPU Puzzles debugging section, where br set -n main initially reports the breakpoint as unresolved even though it resolves correctly once run is executed. It is documented in issue #228

@dunnoconnor dunnoconnor requested review from BradLarson and ehsanmok and removed request for BradLarson March 27, 2026 18:44
Copy link
Copy Markdown
Member

@ehsanmok ehsanmok left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM! thanks. We should revisit the debugging section @dunnoconnor and correct the use of JIT as it was an old execution model and now doesn't apply anymore.

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.

2 participants