cli-anything-lldb

Compétence CLI LLDB

Utilisez cette CLI pour exécuter des workflows de débogage LLDB structurés avec une sortie JSON.

Capacités

• Créer une cible de débogage à partir d'un chemin d'exécutable
• Lancer un processus ou s'attacher par PID/nom
• Gérer les points d'arrêt (définir/lister/supprimer/activer/désactiver)
• Inspecter les threads, cadres, variables locales et la pile d'appels
• Évaluer des expressions dans le cadre actuel
• Lire/trouver de la mémoire du processus
• Charger des coredumps
• REPL interactif avec état de session persistant
• Serveur formel du protocole Debug Adapter Protocol (DAP) sur stdio pour clients IA/éditeurs

Commandes rapides

cli-anything-lldb --json target create --exe /path/to/exe
cli-anything-lldb --json process launch --arg foo --arg bar
cli-anything-lldb --json breakpoint set --function main
cli-anything-lldb --json breakpoint set --function PluginEntry --allow-pending
cli-anything-lldb --json process continue
cli-anything-lldb --json process interrupt
cli-anything-lldb --json thread backtrace --limit 20
cli-anything-lldb --json frame locals
cli-anything-lldb --json expr "myVar"
cli-anything-lldb --json memory read --address 0x1000 --size 64
cli-anything-lldb --json session close

Debug Adapter Protocol

Utilisez le point d'entrée DAP lorsqu'un client IA a besoin d'un cycle de vie complet d'adaptateur de débogage au lieu d'exécuter des commandes CLI séparées :

cli-anything-lldb-dap
cli-anything-lldb-dap --profile /path/to/stop-rules.json

ou :

cli-anything-lldb dap
cli-anything-lldb dap --profile /path/to/stop-rules.json

Le serveur DAP communique via des trames Content-Length sur stdio et doit avoir la main exclusive sur la sortie standard. N'imprimez pas de logs sur la sortie standard autour de son utilisation. Les requêtes supportées incluent initialize, launch, attach, configurationDone, setBreakpoints, setFunctionBreakpoints, threads, stackTrace, scopes, variables, setVariable, evaluate, continue, pause, next, stepIn, stepOut, source, loadedSources, readMemory, modules, exceptionInfo, disassemble et disconnect.

Les variables DAP peuvent exposer des références enfants pour les structures, classes ou tableaux. Utilisez setVariable uniquement lorsque le débogueur est arrêté ; LLDB peut refuser les écritures sur des valeurs optimisées ou en lecture seule.

Pour les débogués GUI de longue durée, le continue DAP est non bloquant du point de vue du client : l'adaptateur envoie d'abord la réponse et l'événement continued, puis attend LLDB sur un thread d'arrière-plan. Le pause DAP utilise l'interruption asynchrone LLDB. Si un agent doit modifier des points d'arrêt pendant que le débogué est en cours d'exécution, l'adaptateur interrompt d'abord et attend un état arrêté avant de modifier les points d'arrêt LLDB ; si la cible ne s'arrête pas à temps, réessayez après un cycle explicite pause/stopped.

Pour les applications GUI qui s'arrêtent sur des points d'arrêt internes de démarrage du débogueur ou de shader-JIT, launch et attach acceptent l'argument booléen non standard autoContinueInternalBreakpoints. Activez-le uniquement lorsque ces arrêts internes sont du bruit pour la tâche ; l'adaptateur émet un événement output avant de continuer automatiquement. Pour un bruit spécifique à la cible, préférez des règles d'arrêt structurées via stopRules en ligne ou un fichier JSON externe stopRuleProfile/--profile. Les règles peuvent correspondre par reason, module, function et/ou regex, puis soit stop avec les métadonnées cliAnythingStop.origin claires, soit continue automatiquement. Utilisez des profils pour des applications comme C4D afin que leurs pièges NVIDIA shader-JIT/démarrage vivent en dehors de l'adaptateur générique.

Les événements DAP stopped incluent body.cliAnythingStop.origin : manualPause pour une demande de pause client, internalTrap pour une règle interne correspondante, et debuggee pour les arrêts de programme ordinaires. Les processus cli-anything-lldb-dap existants ne chargent pas à chaud de nouveau code ou contenu de profil ; redémarrez l'adaptateur et ré-attachez ou relancez avant d'attendre que de nouvelles règles s'appliquent.

Groupes de commandes

target

cli-anything-lldb --json target create --exe /path/to/exe [--arch x86_64]
cli-anything-lldb --json target info

process

cli-anything-lldb --json process launch [--arg ARG ...] [--env KEY=VALUE ...] [--cwd DIR] [--stop-at-entry]
cli-anything-lldb --json process attach --pid 1234
cli-anything-lldb --json process attach --name myapp --wait-for
cli-anything-lldb --json process continue
cli-anything-lldb --json process interrupt
cli-anything-lldb --json process detach
cli-anything-lldb --json process info

breakpoint

cli-anything-lldb --json breakpoint set --function main
cli-anything-lldb --json breakpoint set --file main.c --line 42 --condition "i > 10"
cli-anything-lldb --json breakpoint set --function LateLoadedSymbol --allow-pending
cli-anything-lldb --json breakpoint list
cli-anything-lldb --json breakpoint delete --id 1
cli-anything-lldb --json breakpoint enable --id 1
cli-anything-lldb --json breakpoint disable --id 1

thread / frame / step

cli-anything-lldb --json thread list
cli-anything-lldb --json thread select --id 11111
cli-anything-lldb --json thread backtrace --limit 50
cli-anything-lldb --json frame select --index 0
cli-anything-lldb --json frame info
cli-anything-lldb --json frame locals
cli-anything-lldb --json step over
cli-anything-lldb --json step into
cli-anything-lldb --json step out

expr / memory / core

cli-anything-lldb --json expr "argc"
cli-anything-lldb --json memory read --address 0x1000 --size 128
cli-anything-lldb --json memory find "needle" --start 0x1000 --size 4096
cli-anything-lldb --json core load --path /path/to/core

Notes d'utilisation pour les agents

• Préférez --json pour tous les flux automatisés.
• Les invocations séparées (non REPL) partagent un démon de session persistant par défaut.
• Utilisez --session-file PATH ou CLI_ANYTHING_LLDB_SESSION_FILE pour fixer une session explicite pour une tâche.
• Exécutez cli-anything-lldb --json session close une fois terminé pour que les processus attachés soient détachés et les débogués lancés soient nettoyés.
• Utilisez REPL lorsqu'un shell interactif de type humain est plus pratique, pas parce que la persistance l'exige.
• Les points d'arrêt CLI non résolus échouent par défaut ; passez --allow-pending uniquement lorsqu'un futur chargement de module/symbole est attendu.
• Les points d'arrêt DAP non résolus utilisent la sémantique du protocole : verified: false jusqu'à résolution.
• Le continue DAP est non bloquant pour les processus GUI longue durée, et le pause DAP utilise l'interruption asynchrone.
• Les modifications de points d'arrêt DAP pendant un continue actif interrompent d'abord et attendent un état arrêté avant de modifier LLDB.
• Utilisez des profils de règles d'arrêt DAP pour les pièges internes spécifiques à une application ; redémarrez et ré-attachez/relancez après les modifications du profil.
• memory find utilise un balayage par morceaux limité à 1 Mio par appel.
• Appelez target create avant les commandes de processus ou core.
• Attendez-vous à des erreurs structurées : {"error": "...", "type": "..."}