百科.dev
全部条目在线工具AI 编程趋势榜开源项目技术资讯提交条目
登录
< 返回工具列表
C

Cartographer

> 编程语言
开源

Ghidra 的代码覆盖探索插件

382 stars0 点赞0 次浏览
访问官网GitHub

工具介绍

Ghidra 的代码覆盖探索插件

Cartographer

Mapping Out Code Coverage

Developed by Austin Peavy - https://github.com/aus10pv

Released as open source by NCC Group Plc - https://www.nccgroup.com/
Released under the Apache 2.0 license (see LICENSE for more information)

Description

Cartographer is a code coverage mapping plugin for Ghidra, enabling researchers to observe which parts of a program have been executed without requiring source code.

Table of Contents

  • Key Features
  • Installation
    • Loading the Plugin
  • Usage
    • Loading Code Coverage Files
    • Code Coverage Details
    • Swapping Between Coverages
    • Expression Parser
      • Syntax
      • Examples
  • Contributing
    • Building from Source
    • Reporting Bugs
  • Credits

Key Features

  • Colorizes executed code
    • Function Graph
    • Disassembly (Listing) View
    • Decompiler View
  • Fully customizable colors
  • Supports Ghidra themes
  • Loads DRCOV files and custom EZCOV files
    • See EZCOV.md for details on the EZCOV format
  • Provides a detailed overview of function coverage
    • Includes heat map showing how much of each function was executed
  • Easily swap between loaded coverage files
  • Search for functions by name
  • Filter results by coverage amount and more
  • Powerful expression parser
    • Perform logical operations on multiple loaded coverages
  • Supports coverage in different address spaces

Installation

The latest stable version of Cartographer can be downloaded from the Releases page.

Loading the Plugin

  1. Launch Ghidra.
  2. Navigate to the Install Extensions window.
    • File -> Install Extensions...
  3. Click the green "+" icon at the top-right corner.
  4. Select the downloaded ZIP file to load the plugin into Ghidra.
  5. Click the "OK" button to exit the Install Extensions window.
  6. Restart Ghidra when prompted.

Usage

Once the plugin is loaded, there will be additional controls in the CodeBrowser window for working with code coverage data.

Loading Code Coverage Files

Code coverage files can be loaded via the Tools menu: Tools -> Code Coverage -> Load Code Coverage File(s)...

When a code coverage file is loaded, all of the coverage data is immediately highlighted in the Listing view and the Decompiler view.

Code Coverage Details

Detailed information about the coverage data for each function can be found within the Code Coverage window.

The Code Coverage window can be opened by navigating to Window -> Code Coverage, or by pressing Ctrl-Shift-C on Windows (Cmd-Shift-C on Mac).

This window shows various details about each function in the program:

  • Coverage %: Percentage of the function that was executed
  • Name: Name of the function
  • Address: Address (entry point) of the function
  • Blocks Hit: Number of basic blocks executed
  • Instructions Hit Number of instructions executed
  • Function Size: Size of the function in bytes

Clicking on any function will navigate to the specified function in the Listing view and Decompiler view.

Searching and Filtering

The Filter input box can be used to search for a function by name.

Any of the data displayed in the coverage table can be used as a column filter.

Swapping Between Coverages

The dropdown at the bottom-right of the Code Coverage window can be used to quickly and easily swap between loaded code coverage files.

Expression Parser

The text box at the bottom of the Code Coverage window can be used to perform logical operations on loaded code coverage files.

This can be extremely useful for examining differences and similarities between different runs of a program.

Syntax

Below are the logical operators that can be used within the expression parser.

  • &: Gets only the code executed by both coverages
  • |: Gets any code executed by either coverages
  • ^: Gets only the executed code that differs between the coverages
  • -: Gets only executed code which is unique to the left-hand coverage

Coverages are referenced by their alphabetical IDs in the dropdown menu, such as A, B, XY, etc.

Each logical operation is grouped using parentheses, and expressions can be of any length or complexity.

Examples

  1. Show the code that was executed in both coverages A and B:

    A & B
  2. Show the executed code that was different between coverages A and B:

    A ^ B
  3. Show code that was only executed in B:

    B - A
  4. Combine all of the coverage data found in A and B, then find any differences from C:

    (A | B) ^ C

Contributing

Building from Source

Gradle can be used to build Cartographer from its source code.

  1. Clone the Cartographer GitHub repository.

    $ git clone https://github.com/nccgroup/Cartographer.git
  2. Enter the repository and build with gradle.

    $ cd Cartographer
    $ gradle -PGHIDRA_INSTALL_DIR=
    • Replace `` with the path to your local Ghidra installation path.
  3. After building, the plugin ZIP file will be located in the dist/ folder.

Reporting Bugs

If you've found a bug in Cartographer, please open an issue via GitHub.

Credits

Originally inspired by Lighthouse - https://github.com/gaasedelen/lighthouse

Issues· 0 开放

查看全部 Issues在 GitHub 打开

暂无开放 Issues,或尚未同步最近议题。

> 标签

Java

暂无评论,来聊聊你的看法吧

> 工具信息

发布日期2026年8月1日
最后更新2026年9月17日
分类编程语言
定价开源

> 相关工具

T
TypeScript
JavaScript 的超集,为前端与全栈提供静态类型
P
Python
通用编程语言,广泛用于 Web、数据与 AI
G
Go
Google 推出的简洁高效系统语言