mapbox / mapbox/cpp

Docs on using lldb

Offen
#7 3 Kommentare 0 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen

Dieses Issue hat noch niemand übernommen.

Vorherrschende Sprache
Keine Sprachdaten
Sterne
110
Forks
17
PR-Merge-Kennzahlen
Keine gemergten PRs in 30 T.

Beschreibung

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
  • How to use lldb to interactively debug
  • How to use lldb from within XCode gui (refs #8)

Beitragsleitfaden

Beitragsleitfaden öffnen

Erste Schritte

  1. Lies das ganze Issue und danach den Beitragsleitfaden des Projekts.
  2. Schreib ins Issue, dass du es übernimmst — das erspart doppelte Arbeit.
  3. Forke das Repository und arbeite in einem Branch.
  4. Öffne einen Pull Request, der die Issue-Nummer nennt.

Rechercherichtung

Beginne damit, den Einstiegspunkt der C++-Debugging-Dokumentation im Repository zu finden, und prüfe die LLDB-Befehle des Issues. Behandle Debug-Builds, die Suche nach Core-Dateien unter Linux und macOS, Backtraces im Batch-Modus, das erneute Ausführen von Programmen, interaktives Debugging und den Verweis auf die XCode-GUI in #8. Als abgeschlossen gilt die Aufgabe, wenn beide Plattformen für jeden aufgeführten Workflow konsistente, ausführbare Anleitungen enthalten.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Bewertung

Tech-Stack
cpp
Bereich
devtools, documentation
Issue-Typ
Dokumentation
Schwierigkeit
3/5
Geschätzter Aufwand
1-2 Tage
Aktivitätsstatus
Veraltet
Klarheit
Größtenteils klar
Anfängerfreundlichkeit
45/100

Neue Issues direkt in Ihr Postfach

Eine kurze Übersicht über anfängerfreundliche GitHub-Issues.