Debug tes programmes et applications.
LLDB expliqué
DEBUG un programme : Terminal (Xcode et autres inclus)
lldb nom_du_programme # Débogueur LLDB
│ lldb nom_de_lapplication.app
│ │
└───────└──> dans lldb ─> run # lance le programme
├───> exit # sort de lldb
├───>
├───>
LLDB est le débogueur de LLVM, celui qui tourne sous Xcode. Il arrête ton programme là où tu veux (ou là où il plante), te montre la pile d'appels et te laisse lire — et modifier — chaque variable. Xcode n'est qu'une interface au-dessus : toutes les commandes ci-dessous marchent aussi dans sa console (lldb).
Compiler pour déboguer
Sans symboles de debug, LLDB ne connaît ni tes noms de variables ni tes numéros de ligne. Sans -O0, l'optimiseur supprime ou réordonne des variables (<variable not available>).
# Makefile — config Debug
CXXFLAGS += -g -O0
# Xcode : scheme en configuration Debug (par défaut sur ⌘R)
Depuis le Terminal
lldb ./build/MSLearn # binaire
lldb ./build/MSLearn.app # bundle .app : LLDB trouve l'exécutable dedans
lldb -- ./build/MSLearn --width 1280 # avec arguments (après --)
(lldb) run # r — lance le programme
(lldb) process attach --name MSLearn # s'accrocher à une app déjà lancée
(lldb) process attach --name MSLearn --waitfor # attend qu'elle démarre
(lldb) quit # q — sort de lldb (exit marche aussi)
Points d'arrêt
(lldb) b Renderer.cpp:42 # fichier:ligne
(lldb) b Renderer::draw # une fonction C++ (toutes ses surcharges)
(lldb) b -[ApplicationController mouseMoved:] # une méthode Objective-C
(lldb) br set -S doesNotRecognizeSelector: # s'arrête AVANT le crash « unrecognized selector »
(lldb) br set -E objc # sur toute exception Objective-C lancée
(lldb) br set -E c++ # sur tout throw C++
(lldb) br set -f Perspective.cpp -l 30 -c 'i == 7' # conditionnel : seulement au 8ᵉ cube
(lldb) br list # liste numérotée
(lldb) br disable 2 / br delete 2
(lldb) watchpoint set variable m_frame # w s v — s'arrête quand la valeur CHANGE
Avancer pas à pas
(lldb) continue # c — jusqu'au prochain point d'arrêt
(lldb) next # n — ligne suivante, sans entrer dans les appels
(lldb) step # s — entre dans la fonction appelée
(lldb) finish # termine la fonction courante, revient à l'appelant
Lire l'état du programme
(lldb) bt # backtrace : la pile d'appels, frame #0 = où ça s'est arrêté
(lldb) bt all # tous les threads (rendu, audio, main…)
(lldb) frame select 3 # f 3 — remonte dans la pile, sur TON code
(lldb) frame variable # v — toutes les variables locales de la frame
(lldb) v m_instances[2].color # une variable précise (simd::float4 lisible)
(lldb) p m_viewport.width * 0.5f # évalue une expression C++
(lldb) p m_frameCount = 0 # … et peut MODIFIER une valeur en direct
(lldb) po (id)m_device # description Objective-C d'un objet metal-cpp (nom du GPU…)
(lldb) x/4fw &uniforms # mémoire brute : 4 floats de 4 octets
(lldb) image lookup -a 0x100003f2c # quelle fonction se trouve à cette adresse ?
Les objets metal-cpp (MTL::Device*, MTL::Buffer*…) sont de vrais objets Objective-C déguisés : p te donne l'adresse, po (id)ptr te donne leur description. Un 0x0 = pointeur jamais initialisé.
Lire un crash
Thread 1: EXC_BAD_ACCESS (code=1, address=0x0) # déréférencement d'un pointeur nul
Thread 1: EXC_BAD_ACCESS (code=1, address=0x18) # membre d'un objet nul : this == nullptr, offset 0x18
frame #0: libobjc.A.dylib`objc_msgSend # message envoyé à un objet Obj-C libéré (release en trop)
Thread 1: EXC_BAD_INSTRUCTION / brk 1 # assert() raté, ou dépassement détecté par la lib standard
Méthode : bt → repère la première frame qui vient de ton code (pas libobjc, Metal, AppKit) → f N → v. La variable à 0x0 ou la valeur absurde est presque toujours là.
Dans Xcode
- Point d'arrêt
- → clic dans la gouttière à gauche du numéro de ligne, ou
⌘\.⌘Yles désactive tous d'un coup. - Point d'arrêt conditionnel / avec action
- → clic droit sur le point d'arrêt → Edit Breakpoint… : Condition (
i == 7), Ignore N passages, Action « Debugger Command » (p m_position) ou « Log Message », et Automatically continue pour journaliser sans s'arrêter. - Exception & Symbolic Breakpoint
- → navigateur des points d'arrêt (
⌘8) →+en bas. Exception Breakpoint =br set -E objc. Symbolic Breakpoint avec-[NSObject(NSObject) doesNotRecognizeSelector:]attrape les « unrecognized selector » au moment exact. - Barre de debug
- → Continue
⌃⌘Y· Step OverF6· Step IntoF7· Step OutF8. Zone de debug⇧⌘Y, console(lldb)à droite de cette zone. - Pile d'appels
- → navigateur de debug (
⌘7) : un clic sur une frame =frame select. Les frames grisées n'ont pas de code source (frameworks Apple). - Variables
- → vue de gauche de la zone de debug ; survol d'une variable dans l'éditeur ; l'icône 👁 affiche un aperçu (Quick Look).
Diagnostics à activer (Product → Scheme → Edit Scheme → Run → Diagnostics)
- Address Sanitizer
- → dépassement de tableau, use-after-free, double free : arrêt sur la ligne fautive au lieu d'un crash aléatoire plus tard. Terminal :
-fsanitize=address. - Undefined Behavior Sanitizer
- → division par zéro, débordement d'entier signé, cast invalide. Terminal :
-fsanitize=undefined. - Zombie Objects
- → transforme un
objc_msgSendsur objet libéré en message clair « message sent to deallocated instance ». Terminal :NSZombieEnabled=YES. - Metal API Validation / Shader Validation
- → vérifie chaque appel Metal (buffer trop petit, format de pixel incompatible, index hors limites dans un shader). Terminal :
MTL_DEBUG_LAYER=1 MTL_SHADER_VALIDATION=1 ./build/MSLearn. - Capture GPU
- → icône Metal de la barre de debug (Capture GPU Workload) : inspecte une frame, chaque draw call, ses buffers, ses textures et le shader ligne par ligne.
# Les mêmes diagnostics sous LLDB en Terminal
(lldb) settings set target.env-vars MTL_DEBUG_LAYER=1 MTL_SHADER_VALIDATION=1 NSZombieEnabled=YES
(lldb) run
Tu auras un maximum d'informations, si un fichier n'a pas pû être trouvé, si tu as accédé à une pointeur inexistant ou mal initialisé..
-[ApplicationController mouseMoved:]: unrecognized selector sent to instance 0x95f982e60 air-lld command failed with exit code 1 (use -v to see invocation) .- unrecognized selector sent to instance
- → une classe a été déclarée sans ses méthodes obligatoires
- air-lld command failed with exit code 1 (use -v to see invocation)
- → tu as deux shaders du même nom dans ton projet
- EXC_BAD_ACCESS / frame#: libobjc.A.dylib`objc_msgSend
- → ton programme appelle une méthode (objc_msgSend) sur un pointeur Objective-C invalide ou libéré.
- Multiple commands produceMultiple commands produce
- → doublon dans les build phases (assets).
Erreurs documentées 3
Général
Error 404
Symptôme — Le site est inaccessible.
Solution — Contacte-moi.
unrecognized selector sent to instance
Symptôme — La partie du programme écrite en Objective-C & ObjC++ a défini un protocole que tu n'as pas mis en place.
Solution — Vérifie tes fonctions d'entrées utilisateur.
Script pour Blender 5.x
OSError: [Errno 30] Read-only file system:
Symptôme — Python: Traceback (most recent call last):
File "/Text", line 30, in <module>
File "<frozen os>", line 228, in makedirs
Solution —
Sauvegarde le fichier .blend.
Aucune erreur ne correspond.