mirror of
https://github.com/Maschell/GhidraRPXLoader.git
synced 2024-11-21 23:59:15 +01:00
Update the readme
This commit is contained in:
parent
8abfbe2f59
commit
2544ee63d4
16
README.md
16
README.md
@ -1,16 +1,15 @@
|
|||||||
# Ghidra RPX/RPL loader
|
# Ghidra RPX/RPL loader
|
||||||
|
|
||||||
This is a (WIP) simple extension to open .rpx and .rpl files with Ghidra.
|
This is a simple extension to open .rpx and .rpl files with `Ghidra 10.4`.
|
||||||
|
|
||||||
# Dependencies
|
The loader includes the Gekko/Broadway/Espresso processor definitions that are based on the [Ghidra-GameCube-Loader](https://github.com/Cuyler36/Ghidra-GameCube-Loader).
|
||||||
|
|
||||||
This loader uses the Gekko/Broadway processor definitions for Ghidra if found - it is recommended that this should be installed prior to using the loader.
|
In case the Espresso language is not found, the loader will switch to the default PowerPC processor. However, it is not advisable to expect satisfactory results if the program uses paired single instructions.
|
||||||
|
|
||||||
https://github.com/aldelaro5/ghidra-gekko-broadway-lang
|
Imports in official .rpl/.rpx files may display as "func_xyz" instead of the function's actual name. This issue can be resolved by running the `fix_primary_imports.java` script, which is included with this loader.
|
||||||
|
|
||||||
The loader will fallback to the default PowerPC processor if the Gekko/Broadway language is not found, but do not expect good results if the program uses any paired single instructions.
|
|
||||||
|
|
||||||
## Building
|
## Building
|
||||||
|
|
||||||
- Ensure you have ``JAVA_HOME`` set to the path of your JDK 17 installation.
|
- Ensure you have ``JAVA_HOME`` set to the path of your JDK 17 installation.
|
||||||
- Set ``GHIDRA_INSTALL_DIR`` to your Ghidra install directory. This can be done in one of the following ways:
|
- Set ``GHIDRA_INSTALL_DIR`` to your Ghidra install directory. This can be done in one of the following ways:
|
||||||
- **Windows**: Running ``set GHIDRA_INSTALL_DIR=<Absolute path to Ghidra without quotations>``
|
- **Windows**: Running ``set GHIDRA_INSTALL_DIR=<Absolute path to Ghidra without quotations>``
|
||||||
@ -21,13 +20,16 @@ The loader will fallback to the default PowerPC processor if the Gekko/Broadway
|
|||||||
- You'll find the output zip file inside `/dist`
|
- You'll find the output zip file inside `/dist`
|
||||||
|
|
||||||
## Installation
|
## Installation
|
||||||
|
|
||||||
- Copy the zip file to ``<Ghidra install directory>/Extensions/Ghidra``.
|
- Copy the zip file to ``<Ghidra install directory>/Extensions/Ghidra``.
|
||||||
- Start Ghidra and use the "Install Extensions" dialog to finish the installation. (``File -> Install Extensions...``).
|
- Start Ghidra and use the "Install Extensions" dialog to finish the installation. (``File -> Install Extensions...``).
|
||||||
|
|
||||||
## Usage
|
## Usage
|
||||||
|
|
||||||
- Choose the `Gekko/Broadway/Espresso` language if asked
|
- Choose the `Gekko/Broadway/Espresso` language if asked
|
||||||
|
- Run the `fix_primary_imports.java` script if imports are not displayed properly
|
||||||
|
|
||||||
# Credits
|
# Credits
|
||||||
|
|
||||||
- Based on https://github.com/Relys/rpl2elf
|
- Based on https://github.com/Relys/rpl2elf
|
||||||
- https://github.com/Cuyler36/Ghidra-GameCube-Loader
|
- Based on https://github.com/Cuyler36/Ghidra-GameCube-Loader
|
Loading…
Reference in New Issue
Block a user