isle/tools/ghidra_scripts
2024-05-23 21:51:10 +02:00
..
lego_util run black 2024-05-23 20:38:43 +02:00
import_functions_from_pdb.py fix types and small type safety violations 2024-05-23 21:51:10 +02:00
README.md Refactor: Introduce submodules and reload remedy 2024-05-23 20:06:42 +02:00

Ghidra Scripts

The scripts in this directory provide additional functionality in Ghidra, e.g. imports of symbols from the PDB debug symbol file.

Setup

Ghidrathon

Since these scripts and its dependencies are written in Python 3, Ghidrathon must be installed first. Follow the instructions and install a recent build (these scripts were tested with Python 3.12 and Ghidrathon v4.0.0).

Script Directory

  • In Ghidra, Open Window -> Script Manager.
  • Click the Manage Script Directories button on the top right.
  • Click the Add (Plus icon) button and select this file's parent directory.
  • Close the window and click the Refresh button.
  • This script should now be available under the folder LEGO1.

Development

  • Type hints for Ghira (optional): Download a recent release from https://github.com/VDOO-Connected-Trust/ghidra-pyi-generator, unpack it somewhere, and pip install that directory in this virtual environment. This provides types and headers for Python. Be aware that some of these files contain errors - in particular, from typing import overload seems to be missing everywhere, leading to spurious type errors.
  • Note that the imported modules persist across multiple runs of the script (see here). If you indend to modify an imported library, you have to use import importlib; importlib.reload(${library}) or restart Ghidra for your changes to have any effect.