Cartographer

Mappare la copertura del codice

Sviluppato da Austin Peavy - https://github.com/aus10pv

Rilasciato come open source da NCC Group Plc - https://www.nccgroup.com/
Rilasciato sotto licenza Apache 2.0 (vedi LICENSE per maggiori informazioni)

Descrizione

Cartographer è un plugin di mappatura della code coverage per Ghidra che consente ai ricercatori di osservare quali parti di un programma sono state eseguite senza richiedere il codice sorgente.

Indice

• Funzionalità principali
• Installazione
  • Caricamento del plugin
• Utilizzo
  • Caricamento dei file di code coverage
  • Dettagli della code coverage
  • Passare da una coverage all'altra
  • Parser di espressioni
    • Sintassi
    • Esempi
• Contribuire
  • Compilazione dal sorgente
  • Segnalazione di bug
• Crediti

Funzionalità principali

• Colorizza il codice eseguito
  • Grafo della funzione
  • Vista Disassembly (Listing)
  • Vista Decompiler
• Colori completamente personalizzabili
• Supporta i temi di Ghidra
• Carica file DRCOV e file EZCOV personalizzati
  • Vedi EZCOV.md per i dettagli sul formato EZCOV
• Fornisce una panoramica dettagliata della copertura delle funzioni
  • Include una mappa di calore che mostra quanto di ogni funzione è stato eseguito
• Passa facilmente da un file di coverage caricato all'altro
• Cerca funzioni per nome
• Filtra i risultati per quantità di copertura e altro
• Potente parser di espressioni
  • Esegui operazioni logiche su più coverage caricate
• Supporta la coverage in diversi spazi di indirizzi

Installazione

L'ultima versione stabile di Cartographer può essere scaricata dalla pagina Releases.

Caricamento del plugin

1. Avvia Ghidra.
2. Vai alla finestra Install Extensions.
   • File -> Install Extensions...
3. Fai clic sull'icona verde "+" nell'angolo in alto a destra.
4. Seleziona il file ZIP scaricato per caricare il plugin in Ghidra.
5. Fai clic sul pulsante "OK" per uscire dalla finestra Install Extensions.
6. Riavvia Ghidra quando richiesto.

Utilizzo

Una volta caricato il plugin, nella finestra CodeBrowser saranno disponibili controlli aggiuntivi per lavorare con i dati di code coverage.

Caricamento dei file di code coverage

I file di code coverage possono essere caricati tramite il menu Tools: Tools -> Code Coverage -> Load Code Coverage File(s)...

Quando viene caricato un file di code coverage, tutti i dati di copertura vengono immediatamente evidenziati nella vista Listing e nella vista Decompiler.

Dettagli della code coverage

Informazioni dettagliate sui dati di copertura per ciascuna funzione sono disponibili nella finestra Code Coverage.

La finestra Code Coverage può essere aperta andando su Window -> Code Coverage oppure premendo Ctrl-Shift-C su Windows (Cmd-Shift-C su Mac).

Questa finestra mostra vari dettagli su ciascuna funzione del programma:

• Coverage %: Percentuale della funzione eseguita
• Name: Nome della funzione
• Address: Indirizzo (punto di ingresso) della funzione
• Blocks Hit: Numero di blocchi di base eseguiti
• Instructions Hit Numero di istruzioni eseguite
• Function Size: Dimensione della funzione in byte

Facendo clic su una funzione si passerà alla funzione specificata nella vista Listing e nella vista Decompiler.

Ricerca e filtri

La casella di input Filter può essere utilizzata per cercare una funzione per nome.

Qualsiasi dato visualizzato nella tabella di copertura può essere utilizzato come filtro di colonna.

Passare da una coverage all'altra

Il menu a tendina in basso a destra nella finestra Code Coverage può essere utilizzato per passare rapidamente e facilmente da un file di code coverage caricato all'altro.

Parser di espressioni

La casella di testo in fondo alla finestra Code Coverage può essere utilizzata per eseguire operazioni logiche sui file di code coverage caricati.

Questo può essere estremamente utile per esaminare differenze e somiglianze tra diverse esecuzioni di un programma.

Sintassi

Di seguito sono elencati gli operatori logici che possono essere utilizzati all'interno del parser di espressioni.

• &: Ottiene solo il codice eseguito da entrambe le coverage
• |: Ottiene qualsiasi codice eseguito da una o dall'altra delle coverage
• ^: Ottiene solo il codice eseguito che differisce tra le coverage
• -: Ottiene solo il codice eseguito che è unico nella coverage di sinistra

Le coverage sono identificate dai loro ID alfabetici nel menu a tendina, come A, B, XY, ecc.

Ogni operazione logica è raggruppata tra parentesi e le espressioni possono essere di qualsiasi lunghezza o complessità.

Esempi

1. Mostra il codice eseguito in entrambe le coverage A e B:

   root@kitploit:~

   A & B
   

2. Mostra il codice eseguito che era diverso tra le coverage A e B:

   root@kitploit:~

   A ^ B
   

3. Mostra il codice che è stato eseguito solo in B:

   root@kitploit:~

   B - A
   

4. Combina tutti i dati di copertura trovati in A e B, quindi trova eventuali differenze rispetto a C:

   root@kitploit:~

   (A | B) ^ C
   

Contribuire

Compilazione dal sorgente

Gradle può essere utilizzato per compilare Cartographer dal suo codice sorgente.

1. Clona il repository GitHub di Cartographer.

   root@kitploit:~

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

2. Entra nel repository e compila con gradle.

   root@kitploit:~

   $ cd Cartographer
   $ gradle -PGHIDRA_INSTALL_DIR=<ghidra_install_dir>
   

   • Sostituisci <ghidra_install_dir> con il percorso della tua installazione locale di Ghidra.

3. Dopo la compilazione, il file ZIP del plugin si troverà nella cartella dist/.

Segnalazione di bug

Se hai trovato un bug in Cartographer, apri una segnalazione tramite GitHub.

Crediti

Originariamente ispirato da Lighthouse - https://github.com/gaasedelen/lighthouse