/ghidra-delinker-extension

Ghidra extension for exporting relocatable object files

Primary LanguageJavaApache License 2.0Apache-2.0

Object file exporter extension for Ghidra

This Ghidra extension enables exporting parts of a program as object files. These object files have valid metadata (symbols, relocation tables…) and as such can be reused directly by a toolchain for further processing.

Use-cases include:

  • Advanced binary patching, by leveraging the linker to mend both original and modified parts together instead of doing this work by hand ;
  • Software ports, by isolating system-independent code from a program and replacing the rest ;
  • Converting programs or object files from one file format to another ;
  • Creating libraries, by extracting parts of a program and reusing them in another context ;
  • Decompilation projects, by splitting a program into multiple object files and reimplementing these Ship of Theseus-style ;
  • …

Matrix of supported instruction set architectures and object files:

x86 MIPS
COFF ✅ ❌
ELF ✅ ✅

Building (CLI)

  • Clone this repository ;
  • Define the GHIDRA_INSTALL_DIR environment variable to point to your Ghidra installation directory ;
  • Run gradle buildExtension.

The Ghidra extension archive will be created inside the dist/ directory.

Installation

  • Download the extension from the releases page or build it locally ;
  • Install the extension in your Ghidra instance with File > Install Extensions… ;
  • Enable the RelocationTableSynthesizedPlugin plugin with File > Configure inside a CodeBrowser window.

Usage

  1. Select a set of addresses in the Listing view ;
  2. Run the Relocation table synthesizer analyzer (available in one-shot mode) ;
  3. Invoke a relocatable object file exporter with File > Export Program…

The reconstructed relocations can be viewed with Window > Relocation table (synthesized).

  • ⚠️ The relocation table synthesizer analyzer relies on a fully populated Ghidra database (with correctly declared symbols, data types and references) in order to work. Incorrect or missing information may lead to broken or undiscovered relocations during the analysis.
  • ⚠️ The object file exporters rely on the results of the relocation table synthesizer analyzer in order to work. When in doubt, run this analyzer right before exporting an object file to make sure the relocation table contents are up-to-date with the current state of the program.

How does it work?

Object files are made of three parts:

  • Relocatable section bytes ;
  • A symbol table ;
  • A relocation table.

When a linker is invoked to generate an executable from a bunch of object files, it will:

  • Lay out their sections in memory ;
  • Compute the addresses of the symbols in the virtual address space ;
  • Apply the relocations based on the final addresses of the symbols onto the section bytes.

Normally the relocation table is discarded after this process, as well as the symbol table if debugging symbols aren't kept, leaving only the un-relocatable section bytes. However, through careful analysis this data can be recreated, which allows us to then effectively delink the program back into object files.