Docs on using lldb
Nobody has claimed this yet.
Assessment
- Difficulty
- 3/5
- Estimated time
- 1-2 days
- Newbie friendliness
- 45/100
- Issue type
- Documentation
- Clarity
- Mostly clear
- Activity status
- Stale
- Tech stack
- cpp
- Domain
- devtools, documentation
Research direction
Start by locating the C++ debugging documentation entry point in the repository and review the issue's LLDB commands. Cover debug builds, core-file discovery on Linux and macOS, batch backtraces, rerunning programs, interactive debugging, and the XCode GUI reference in #8. Done means both platforms have consistent, runnable guidance for each listed workflow.
Written by the indexing model from the issue text.
Description
Upcoming mason provides packages for lldb 3.9.x that are identical on os x and linux: https://github.com/mapbox/mason/pull/253. This means we can and should write consistent docs for how to debug C++ programs on both platforms.
Topics to cover:
- How to build your program in debug mode
- How to use lldb to generate backtraces
- Via a core file:
lldb -c $(ls -t /cores/* | head -n1) --batch -o 'thread backtrace all' -o 'quit'- How to ensure core files are created and found on linux vs osx
- Via re-running the program with lld:
lldb --batch -o 'run' -k 'thread backtrace all' -k 'quit 1' node /path/to/script.js
- Via a core file:
- How to use lldb to interactively debug
- How to use lldb from within XCode gui (refs #8)
- Dominant language
- No language data
- Stars
- 110
- Forks
- 17
- PR merge metrics
- No merged PRs in 30d
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from mapbox/cpp
-
glossary
Difficulty 1/5 Under an hour Newbie friendliness 68/100
-
Difficulty 3/5 1-2 days Newbie friendliness 25/100
-
Docs on ABIs Open
Difficulty 4/5 3-5 days Newbie friendliness 30/100
-
Difficulty 5/5 Over a week Newbie friendliness 30/100
-
Difficulty 3/5 1-2 days Newbie friendliness 35/100
Similar issues
-
Difficulty 2/5 1-3 hours Newbie friendliness 88/100
use-agent-os/agent-os#3314 ·
-
documentation low-priority templates
Difficulty 2/5 1-3 hours Newbie friendliness 85/100
jesseray718/openroot#87 ·
-
factory-active factory-automatic task-bug-reproduction-cannot-reproduce task-identify-harness-labels-done task-identify-issue-type-done
Difficulty 2/5 1-3 hours Newbie friendliness 84/100
-
Difficulty 2/5 1-3 hours Newbie friendliness 90/100
danielmiessler/LifeOS#2218 ·
-
in-progress proposal
Difficulty 1/5 Under an hour Newbie friendliness 88/100
uibcdf/molsyssuite#36 ·