Cartographer

Cartographie de la couverture de code

Développé par Austin Peavy - https://github.com/aus10pv

Publié en open source par NCC Group Plc - https://www.nccgroup.com/
Publié sous licence Apache 2.0 (voir LICENSE pour plus d'informations)

Description

Cartographer est un plugin de cartographie de la couverture de code pour Ghidra, permettant aux chercheurs d'observer quelles parties d'un programme ont été exécutées sans avoir besoin du code source.

Table des matières

• Fonctionnalités clés
• Installation
  • Chargement du plugin
• Utilisation
  • Chargement des fichiers de couverture de code
  • Détails de la couverture de code
  • Basculer entre les couvertures
  • Analyseur d'expressions
    • Syntaxe
    • Exemples
• Contribuer
  • Compiler à partir des sources
  • Signaler des bogues
• Crédits

Fonctionnalités clés

• Colorise le code exécuté
  • Graphe de fonction
  • Vue de désassemblage (Listing)
  • Vue du décompilateur
• Couleurs entièrement personnalisables
• Prend en charge les thèmes Ghidra
• Charge les fichiers DRCOV et les fichiers EZCOV personnalisés
  • Voir EZCOV.md pour plus de détails sur le format EZCOV
• Fournit un aperçu détaillé de la couverture des fonctions
  • Inclut une carte de chaleur indiquant la part de chaque fonction exécutée
• Permet de basculer facilement entre les fichiers de couverture chargés
• Recherche des fonctions par nom
• Filtre les résultats par taux de couverture et plus encore
• Analyseur d'expressions puissant
  • Effectue des opérations logiques sur plusieurs couvertures chargées
• Prend en charge la couverture dans différents espaces d'adressage

Installation

La dernière version stable de Cartographer peut être téléchargée depuis la page Releases.

Chargement du plugin

1. Lancez Ghidra.
2. Accédez à la fenêtre Install Extensions.
   • File -> Install Extensions...
3. Cliquez sur l'icône verte "+" en haut à droite.
4. Sélectionnez le fichier ZIP téléchargé pour charger le plugin dans Ghidra.
5. Cliquez sur le bouton "OK" pour fermer la fenêtre Install Extensions.
6. Redémarrez Ghidra lorsque vous y êtes invité.

Utilisation

Une fois le plugin chargé, des contrôles supplémentaires seront disponibles dans la fenêtre CodeBrowser pour travailler avec les données de couverture de code.

Chargement des fichiers de couverture de code

Les fichiers de couverture de code peuvent être chargés via le menu Tools : Tools -> Code Coverage -> Load Code Coverage File(s)...

Lorsqu'un fichier de couverture de code est chargé, toutes les données de couverture sont immédiatement mises en évidence dans la vue Listing et la vue Decompiler.

Détails de la couverture de code

Des informations détaillées sur les données de couverture de chaque fonction sont disponibles dans la fenêtre Code Coverage.

La fenêtre Code Coverage peut être ouverte en allant dans Window -> Code Coverage, ou en appuyant sur Ctrl-Shift-C sous Windows (Cmd-Shift-C sous Mac).

Cette fenêtre affiche divers détails sur chaque fonction du programme :

• Coverage %: Pourcentage de la fonction exécutée
• Name: Nom de la fonction
• Address: Adresse (point d'entrée) de la fonction
• Blocks Hit: Nombre de blocs de base exécutés
• Instructions Hit Nombre d'instructions exécutées
• Function Size: Taille de la fonction en octets

Cliquer sur une fonction permet de naviguer vers la fonction sélectionnée dans la vue Listing et la vue Decompiler.

Recherche et filtrage

Le champ de saisie Filter peut être utilisé pour rechercher une fonction par nom.

Toutes les données affichées dans le tableau de couverture peuvent être utilisées comme filtre de colonne.

Basculer entre les couvertures

La liste déroulante en bas à droite de la fenêtre Code Coverage permet de basculer rapidement et facilement entre les fichiers de couverture chargés.

Analyseur d'expressions

La zone de texte en bas de la fenêtre Code Coverage peut être utilisée pour effectuer des opérations logiques sur les fichiers de couverture chargés.

Cela peut être extrêmement utile pour examiner les différences et les similitudes entre différentes exécutions d'un programme.

Syntaxe

Voici les opérateurs logiques qui peuvent être utilisés dans l'analyseur d'expressions.

• &: Obtient uniquement le code exécuté par les deux couvertures
• |: Obtient tout code exécuté par l'une ou l'autre des couvertures
• ^: Obtient uniquement le code exécuté qui diffère entre les couvertures
• -: Obtient uniquement le code exécuté qui est exclusif à la couverture de gauche

Les couvertures sont référencées par leurs identifiants alphabétiques dans le menu déroulant, comme A, B, XY, etc.

Chaque opération logique est regroupée à l'aide de parenthèses, et les expressions peuvent être de n'importe quelle longueur ou complexité.

Exemples

1. Affiche le code exécuté dans les deux couvertures A et B :

   root@kitploit:~

   A & B
   

2. Affiche le code exécuté qui était différent entre les couvertures A et B :

   root@kitploit:~

   A ^ B
   

3. Affiche le code qui a été exécuté uniquement dans B :

   root@kitploit:~

   B - A
   

4. Combinez toutes les données de couverture trouvées dans A et B, puis recherchez les différences par rapport à C :

   root@kitploit:~

   (A | B) ^ C
   

Contribuer

Compiler à partir des sources

Gradle peut être utilisé pour compiler Cartographer à partir de son code source.

1. Clonez le dépôt GitHub de Cartographer.

   root@kitploit:~

   $ git clone https://github.com/nccgroup/Cartographer.git
   

2. Entrez dans le dépôt et compilez avec Gradle.

   root@kitploit:~

   $ cd Cartographer
   $ gradle -PGHIDRA_INSTALL_DIR=<ghidra_install_dir>
   

   • Remplacez <ghidra_install_dir> par le chemin de votre installation locale de Ghidra.

3. Après la compilation, le fichier ZIP du plugin se trouvera dans le dossier dist/.

Signaler des bogues

Si vous avez trouvé un bogue dans Cartographer, veuillez ouvrir un ticket via GitHub.

Crédits

À l'origine inspiré par Lighthouse - https://github.com/gaasedelen/lighthouse