This commit is contained in:
Maxim Poliakovski 2021-03-22 02:19:29 +01:00 committed by GitHub
parent 0a975c64f5
commit a636439b47
No known key found for this signature in database
1 changed files with 25 additions and 0 deletions

25 Normal file
View File

@ -0,0 +1,25 @@
# PowerRomDasm
An attempt to disassemble a Power Macintosh ROM using widely available disassemblers
will likely lead to disappointing results. While some state-of-the-art disassemblers
employ various heurictics for distinguishing embedded data from executable code,
a lot of additional manual work still need to be done to produce a nice disassembly.
Additionally, Power Macintosh ROMs contain code for several CPU architectures
(68k, PowerPC, FCode) so a multi-architecture disassembler is required for telling
all this stuff apart.
The purpose of this repository is to provide a tool for producing a nice disassembly
for the existing Power Macintosh ROM dumps annotated with various symbols like
function names, entry points etc. The resulting text dump can be used for easier debugging
of MacOS system software and emulator development.
## Prerequisites
The following components are required to run PowerRomDasm:
- Python 3
- Python bindings for [Capstone disassembler framework](
## Usage
python3 --rom_path=[path to a Power Macintosh ROM dump] --start=0 --end=0x300