mirror of
https://github.com/isledecomp/isle-portable.git
synced 2024-11-22 15:37:55 -05:00
|
|
||
|---|---|---|
| .. | ||
| lego_util | ||
| import_functions_and_types_from_pdb.py | ||
| README.md | ||
Ghidra Scripts
The scripts in this directory provide additional functionality in Ghidra, e.g. imports of symbols and types 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.
Virtual environment
As of now, there must be a Python virtual environment set up under $REPOSITORY_ROOT/.venv, and the dependencies of isledecomp must be installed there, see here.
Development
- Type hints for Ghidra (optional): Download a recent release from https://github.com/VDOO-Connected-Trust/ghidra-pyi-generator,
unpack it somewhere, and
pip installthat 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 overloadseems 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. Unfortunately, even that is not perfectly reliable, so you may still have to restart Ghidra for some changes inisledecompto be applied.