An interactive ncurses debugger for the global optimization pass of the IDO C compiler.
Due to hardware differences, alignment issues, and probably subtle bugs in the decompilation, only the 32-bit version of uopt on x86 behaves correctly.
Install 32-bit ncurses and gcc, then type make.
To install 32-bit packages on Ubuntu run the following:
sudo dpkg --add-architecture i386 && sudo apt update
These are some of the requirements (not comprehensive):
sudo apt install libncurses6:i386 libtinfo-dev:i386
Run ./udb.py path/to/source/file.c [make flags]
This compiles the given file, but runs the debugger instead of uopt.
The script assumes that your decomp project uses make as a build system, and that it uses n64decomp/ido-static-recomp instead of qemu-irix.
The main keys to know are c (color) and x/X (examine).
| Key | Action |
|---|---|
| hjkl | Move the cursor |
| ^$ | Move cursor to start/end of line |
| gG | Jump to top / bottom of tile |
| du | Jump half a page down / up |
| C-F | Jump one page down |
| C-B | Jump one page up |
| s | Split window horizontally, creating a new window below the current one |
| S | Split window vertically, creating a new window to the right of the current one |
| Esc | Open the tile menu in the current window |
| Enter | While in the tile menu, open the tile under the cursor |
| HJKL | Move cursor to a different window |
| q | Close the current window (unless there is only one window) |
| Q | Stop debugging the current function, advance to the next one in the file |
| c | Globally highlight whatever object is under the cursor |
| C-L | Redraw the current window |
| C-L C-L | Redraw all windows |
| xX | Examine whatever object the cursor is on. Opens a new window that displays the struct's fields and their values |
| v | Highlight each distinct object on the current line in a different color, up to a depth. The depth highlighted increases with each press |
| V | Like v, but decreases the depth |
See also the functions named *_tile_input in ncdebug.c for other controls specific to certain windows.
These keys will probably be removed, so they aren't worth including in the table above.
This project aims to decompile IDO 7.1, and maybe 5.3 too.
The src directory for uopt was created using the following command:
mkdir src
cd src
../mipsdisasm/elfdump -i -p ~/ido7.1_compiler/usr/lib/uopt -t ../uopt_split_specification.txt
To generate an assembly file that can easily be used with mips_to_c, run the following command:
mipsdisasm/elfdump -i -r -p ~/ido7.1_compiler/usr/lib/uopt > uopt71.s
The resulting C files can be compiled with mips-linux-gnu-gcc with the args -c -fPIC.
