Aller au contenu

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) :

file core

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_CORE atteint pendant l'écriture : le fichier reste reconnu comme core file mais ne porte pas la note ;
  • file indisponible — côté hôte, où il n'est pas un prérequis du projet (les prérequis sont git, 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 :

  • gdb n'est pas installé. L'image de dev liste ses paquets explicitement dans le Dockerfile ; gdb n'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 le Dockerfile, pas modifiée en place.
  • Le binaire php ne porte pas de symboles de debug. Il est livré stripped, sans section DWARF. À vérifier d'un coup d'œil dans le conteneur :

    file "$(command -v php)"
    

    Avec un binaire dépouillé, même gdb ne 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 0 reste votre décision, pour ce run et lui seul ;
  • /core est gitignoré, pas core.<pid> : avec un core_pattern portant %p, le fichier apparaît dans git status comme un fichier non suivi ;
  • core n'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 :

mkdir -p ~/cores
mv <chemin du worktree>/core ~/cores/kirexo-$(date +%Y%m%d-%H%M).core

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 :

rm -f core

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