Exploiter un coredump¶
Vous êtes développeur·se sur Kirexo, un fichier core de plusieurs gigaoctets vient d'apparaître à la racine du dépôt, et vous voulez savoir ce qui l'a produit avant de décider quoi en faire.
Ce n'est pas une manipulation simple
Ouvrir un coredump et en tirer une pile lisible n'est pas faisable avec l'image de développement du projet (étape 2), et la procédure de repli demande de construire un environnement d'analyse à part. Dans la grande majorité des cas, la seule ligne que rend file suffit à identifier la commande fautive et à la rejouer — c'est le meilleur rapport effort/résultat, et c'est l'objet de l'étape 1.
D'où vient l'alerte¶
Le projet détecte les coredumps à la racine, sur deux surfaces, avec la même bibliothèque (infra/coredump/coredump.lib.sh) :
| Surface | Ce qui s'affiche |
|---|---|
Dashboard de session Claude (.claude/hooks/session-dashboard.sh) |
Un bloc 🧨 Coredump à la racine du dépôt : chemin, taille, date, commande d'origine, commande de suppression proposée. |
castor wt:list, côté hôte |
La colonne core ? (2 coredumps · 4,1 Go), et sous le tableau une ligne par worktree concerné avec la commande de suppression. |
La détection tient sur deux gardes : le nom (core, ou core.<pid> quand le core_pattern du noyau porte %p) et, quand l'outil file est disponible, la signature magique ELF. Un core.json, un coreutils ou un hardcore.md ne déclenchent donc rien.
Le scan est volontairement limité à la racine (-maxdepth 1) : le noyau écrit le core dans le répertoire courant du processus, et celui de FrankenPHP comme de PHPUnit est la racine du dépôt.
Étape 1 — Lire ce que file restitue¶
Depuis le conteneur (l'image de dev embarque le paquet file) :
La sortie est une ligne unique de cette forme :
core: ELF 64-bit LSB core file, x86-64, version 1 (SYSV), SVR4-style, from 'php -d memory_limit=2G vendor/bin/phpunit --path-coverage', real uid: 1000, effective uid: 1000, real gid: 1000, effective gid: 1000, execfn: '/usr/local/bin/php', platform: 'x86_64'
Le champ exploitable est from '…'. Il vient de la note ELF NT_PRPSINFO du core, champ pr_psargs, où le noyau a recopié la ligne de commande du processus au moment du crash.
Le noyau tronque pr_psargs à 80 caractères
La limite est ELF_PRARGSZ, côté noyau : une commande longue ressort coupée, sans ellipse ni indication. Ce n'est ni un défaut de file, ni un défaut du parsing du projet (coredump_parse_command). Une commande PHPUnit avec beaucoup d'options est typiquement tronquée en plein milieu de sa liste d'arguments.
Deux cas rendent le champ vide, et l'alerte s'affiche quand même avec la mention produit par : inconnu :
- core tronqué — disque plein ou
RLIMIT_COREatteint pendant l'écriture : le fichier reste reconnu commecore filemais ne porte pas la note ; fileindisponible — côté hôte, où il n'est pas un prérequis du projet (les prérequis sontgit,docker,docker compose,castor,jq,glab).
Le suspect habituel sur ce projet est une mesure de couverture : PHPUnit sous Xdebug avec un memory_limit déplafonné segfaute, et c'est précisément ce que les consignes de test interdisent. Si la ligne from nomme un vendor/bin/phpunit, relisez Exécuter les tests avant de rejouer la commande à l'identique.
Étape 2 — Pourquoi l'analyse s'arrête là dans l'image dev¶
Trois obstacles, cumulatifs :
gdbn'est pas installé. L'image de dev liste ses paquets explicitement dans leDockerfile;gdbn'y figure pas. Il ne peut pas non plus être ajouté depuis l'intérieur : le conteneur n'a pas d'accès réseau libre (allowlist du proxy sortant) et l'image est reconstruite depuis leDockerfile, pas modifiée en place.-
Le binaire
phpne porte pas de symboles de debug. Il est livré stripped, sans section DWARF. À vérifier d'un coup d'œil dans le conteneur :Avec un binaire dépouillé, même
gdbne rendrait qu'une pile d'adresses brutes, sans nom de fonction. - Aucun paquet de symboles séparé n'est disponible pour cette image : il n'y a rien à recoller aux adresses.
Autrement dit : le conteneur sait vous dire quel core existe et quelle commande l'a produit. Il ne sait pas l'ouvrir.
Étape 3 — Décider : ce que le projet fait, et ne fait pas¶
La position est tranchée, et elle est délibérée :
| Le projet… | |
|---|---|
| détecte | dashboard de session et castor wt:list — un fichier de plusieurs gigaoctets ne doit pas s'accumuler sans que personne ne le voie. |
| n'interdit pas | aucun ulimit -c n'est posé : ni dans l'image, ni dans les fichiers Compose, ni dans une cible Castor. Un core est la seule trace exploitable d'un segfault ; l'interdire pour économiser du disque rend la panne suivante indébuggable. |
| ne supprime jamais | la commande rm -f core est proposée dans un message, jamais exécutée. L'arbitrage est humain, comme pour castor wt:gc. |
Trois précisions utiles :
- rien n'empêche un choix ponctuel inverse : préfixer une commande connue pour segfauter par
ulimit -c 0reste votre décision, pour ce run et lui seul ; /coreest gitignoré, pascore.<pid>: avec uncore_patternportant%p, le fichier apparaît dansgit statuscomme un fichier non suivi ;coren'est pas dans.dockerignore: tant qu'il est à la racine, il part dans le contexte de build à chaque construction d'image — plusieurs gigaoctets envoyés au démon pour rien.
Depuis une session Claude, le rm n'est pas automatique non plus
Le hook guard-rm.sh n'autorise sans arbitrage que les suppressions strictement sous var/claude/. Un rm -f core à la racine repasse par le flux de permission normal : c'est vous qui tranchez (cf. Hooks Claude Code).
Étape 4 — Analyser côté hôte, si le besoin le justifie¶
À faire seulement si la ligne from '…' ne suffit pas — un crash non reproductible, par exemple.
4.1 Sortir le core du dépôt¶
Le core est à la racine du worktree, qui est bind-monté : il est visible côté hôte au même endroit. Le déplacer suffit, et c'est le premier geste — il le retire du contexte de build, des scans de l'IDE et des sondes du dashboard :
4.2 Ouvrir le core avec gdb¶
Il faut un environnement qui réunit gdb et un binaire php portant des symboles :
docker run --rm -it \
-v ~/cores:/cores:ro \
<image d'analyse> \
gdb /usr/local/bin/php /cores/kirexo-20260705-0412.core
Le binaire doit être celui qui a produit le core
Version de PHP, options de compilation, extensions : un binaire qui diffère donne une pile fausse sans le dire. C'est la partie coûteuse de l'exercice — il n'existe pas d'image d'analyse toute prête dans ce dépôt, et en construire une (même version de PHP, compilée avec ses symboles) est un chantier en soi. C'est exactement pour cette raison que l'étape 1 est le bon réflexe et celle-ci l'exception.
Une fois dans gdb, les commandes utiles :
| Commande | Effet |
|---|---|
bt |
Pile d'appels native du thread courant. |
bt full |
Idem, avec les variables locales de chaque frame. |
thread apply all bt |
Pile de tous les threads — indispensable sur FrankenPHP, qui est multi-threadé. |
info registers |
État des registres au moment du crash. |
Pour remonter jusqu'à la pile PHP userland (et pas seulement la pile C), php-src fournit un fichier .gdbinit avec une macro zbacktrace — qui suppose, elle aussi, des symboles.
Étape 5 — Supprimer, en connaissance de cause¶
Quand vous avez tiré ce qu'il y avait à en tirer :
C'est exactement la commande que proposent le dashboard de session et le pied de tableau de castor wt:list. Aucun automatisme ne l'exécutera à votre place.
Pour aller plus loin¶
- Le hook qui affiche l'alerte au démarrage d'une session : Hooks Claude Code —
session-dashboard.sh. - La colonne
core ?du listing des worktrees : Créer et détruire un worktree. - Les campagnes de couverture, principal producteur de coredumps ici : Exécuter les tests.