Descripción

Cartographer es un plugin de mapeo de cobertura de código para Ghidra, que permite a los investigadores observar qué partes de un programa se han ejecutado sin necesidad de código fuente.

Tabla de contenidos

• Características principales
• Instalación
  • Carga del Plugin
• Uso
  • Carga de Archivos de Cobertura de Código
  • Detalles de la Cobertura de Código
  • Cambio entre Coberturas
  • Analizador de Expresiones
    • Sintaxis
    • Ejemplos
• Contribuciones
  • Compilar desde el Código Fuente
  • Reporte de Errores
• Créditos

Características principales

• Colorea el código ejecutado
  • Gráfico de Funciones
  • Vista de Desensamblado (Listing)
  • Vista del Descompilador
• Colores totalmente personalizables
• Compatible con temas de Ghidra
• Carga archivos DRCOV y archivos EZCOV personalizados
  • Consulte EZCOV.md para obtener detalles sobre el formato EZCOV
• Proporciona una vista detallada de la cobertura de funciones
  • Incluye un mapa de calor que muestra cuánto de cada función se ejecutó
• Cambia fácilmente entre archivos de cobertura cargados
• Busca funciones por nombre
• Filtra resultados por cantidad de cobertura y más
• Potente analizador de expresiones
  • Realiza operaciones lógicas sobre múltiples coberturas cargadas
• Admite cobertura en diferentes espacios de direcciones

Instalación

La última versión estable de Cartographer se puede descargar desde la página de Releases.

Carga del Plugin

1. Inicie Ghidra.
2. Navegue hasta la ventana Install Extensions.
   • File -> Install Extensions...
3. Haga clic en el ícono verde "+" en la esquina superior derecha.
4. Seleccione el archivo ZIP descargado para cargar el plugin en Ghidra.
5. Haga clic en el botón "OK" para salir de la ventana Install Extensions.
6. Reinicie Ghidra cuando se le solicite.

Uso

Una vez cargado el plugin, habrá controles adicionales en la ventana CodeBrowser para trabajar con datos de cobertura de código.

Carga de Archivos de Cobertura de Código

Los archivos de cobertura de código se pueden cargar a través del menú Tools: Tools -> Code Coverage -> Load Code Coverage File(s)...

Cuando se carga un archivo de cobertura de código, todos los datos de cobertura se resaltan inmediatamente en la vista Listing y en la vista Decompiler.

Detalles de la Cobertura de Código

La información detallada sobre los datos de cobertura de cada función se puede encontrar en la ventana Code Coverage.

La ventana Code Coverage se puede abrir navegando a Window -> Code Coverage, o presionando Ctrl-Shift-C en Windows (Cmd-Shift-C en Mac).

Esta ventana muestra varios detalles sobre cada función del programa:

• Coverage %: Porcentaje de la función que se ejecutó
• Name: Nombre de la función
• Address: Dirección (punto de entrada) de la función
• Blocks Hit: Número de bloques básicos ejecutados
• Instructions Hit Número de instrucciones ejecutadas
• Function Size: Tamaño de la función en bytes

Al hacer clic en cualquier función se navegará a la función especificada en la vista Listing y en la vista Decompiler.

Búsqueda y Filtrado

El cuadro de entrada Filter se puede utilizar para buscar una función por nombre.

Cualquiera de los datos mostrados en la tabla de cobertura se puede utilizar como filtro de columna.

Cambio entre Coberturas

El menú desplegable en la parte inferior derecha de la ventana Code Coverage se puede utilizar para cambiar rápida y fácilmente entre archivos de cobertura de código cargados.

Analizador de Expresiones

El cuadro de texto en la parte inferior de la ventana Code Coverage se puede utilizar para realizar operaciones lógicas en archivos de cobertura de código cargados.

Esto puede ser extremadamente útil para examinar diferencias y similitudes entre diferentes ejecuciones de un programa.

Sintaxis

A continuación se muestran los operadores lógicos que se pueden utilizar dentro del analizador de expresiones.

• &: Obtiene solo el código ejecutado por ambas coberturas
• |: Obtiene cualquier código ejecutado por cualquiera de las coberturas
• ^: Obtiene solo el código ejecutado que difiere entre las coberturas
• -: Obtiene solo el código ejecutado que es exclusivo de la cobertura de la izquierda

Las coberturas se referencian por sus IDs alfabéticos en el menú desplegable, como A, B, XY, etc.

Cada operación lógica se agrupa usando paréntesis, y las expresiones pueden tener cualquier longitud o complejidad.

Ejemplos

1. Muestre el código que se ejecutó en ambas coberturas A y B:

   root@kitploit:~

   A & B
   

2. Muestre el código ejecutado que fue diferente entre las coberturas A y B:

   root@kitploit:~

   A ^ B
   

3. Muestre el código que se ejecutó solo en B:

   root@kitploit:~

   B - A
   

4. Combine todos los datos de cobertura encontrados en A y B, y luego encuentre cualquier diferencia con C:

   root@kitploit:~

   (A | B) ^ C
   

Contribuciones

Compilar desde el Código Fuente

Se puede usar Gradle para compilar Cartographer desde su código fuente.

1. Clone el repositorio de Cartographer en GitHub.

   root@kitploit:~

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

2. Entre al repositorio y compile con gradle.

   root@kitploit:~

   $ cd Cartographer
   $ gradle -PGHIDRA_INSTALL_DIR=<ghidra_install_dir>
   

   • Reemplace <ghidra_install_dir> con la ruta de su instalación local de Ghidra.

3. Después de compilar, el archivo ZIP del plugin estará ubicado en la carpeta dist/.

Reporte de Errores

Si ha encontrado un error en Cartographer, abra un issue a través de GitHub.

Créditos

Originalmente inspirado por Lighthouse - https://github.com/gaasedelen/lighthouse