mapbox / mapbox/cpp

Docs on using lldb

Ouverte
#7 3 commentaires 0 réactions 0 personnes assignées Voir sur GitHub

Personne n'a encore pris cette issue.

Langage dominant
Aucune donnée de langage
Étoiles
110
Forks
17
Métriques de merge des PR
Aucune PR mergée en 30 j

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

Guide de contribution

Ouvrir le guide de contribution

Par où commencer

  1. Lisez l'issue en entier, puis le guide de contribution du projet.
  2. Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
  3. Forkez le dépôt et travaillez sur une branche.
  4. Ouvrez une pull request qui référence le numéro de l'issue.

Piste de recherche

Commencez par localiser le point d’entrée de la documentation de débogage C++ dans le dépôt et examinez les commandes LLDB de l’issue. Couvrez les builds de débogage, la recherche de fichiers core sous Linux et macOS, les backtraces en mode batch, la réexécution des programmes, le débogage interactif et la référence à l’interface graphique XCode dans #8. Le travail est terminé lorsque les deux plateformes disposent d’instructions cohérentes et exécutables pour chacun des workflows listés.

Rédigé par le modèle d'indexation à partir du texte de l'issue.

Évaluation

Stack technique
cpp
Domaine
devtools, documentation
Type d'issue
Documentation
Difficulté
3/5
Temps estimé
1-2 jours
Activité
À l'abandon
Clarté
Plutôt claire
Accessibilité débutants
45/100

Recevez les nouvelles issues par e-mail

Un résumé court des issues GitHub adaptées aux débutants.