The izumi project englobes the izumi_tui instruction pipeline dump visualizer and its support library, libizumi.
This repository serves as a central hub for all the project components, providing a unified build system for them. Clone this repository if you want to easily setup a development environment or build all the components at once.
Note
The library and the visualizer are still under development and things may break, specially if you are not careful when choosing the right versions for each one. If you are not actively developing Izumi, please use the main branch of this repository and its referenced submodule commits to ensure stability.
- libizumi: a multi-format instruction pipeline dump parser library.
- izumi_tui: a multi-format instruction pipeline dump TUI visualizer.
ncursesmake(build only)autotools(build from source only, not needed in distribution packages)doxygen(optional, for generating documentation)
If you cloned the repository instead of downloading a distribution package, start by cloning the submodules:
git submodule update --init Then, you will need to generate the build system:
autoreconf --install autoreconf --install libizumi autoreconf --install izumi_tuiWith the configure script available, you can follow the traditional mantra:
mkdir build && cd build # Any path supported! ../configure make (sudo) make installThe configure script options are pretty limited in this repository, so you may want to individually build the different components if you need more control over the build process.
You can also use nix (flakes recommended):
nix run github:Izumi-visualizer/IzumiUse the installed izumi binary...
izumi path/to/file... or use the make wrapper:
make run ARGS=path/to/fileImportant
If sanitizers are enabled, an AddressSanitizer:DEADLYSIGNAL error can be raised randomly when starting the program. Just kill the program and try again. If it persists, please report it.
Note
Some supported example files are on the examples directory. These are generated on the RISC-V core Sargantana.
See the izumi_tui README for more information about the available commands and other features.
See the libizumi README.
I know it's not the best looking tool, but it's a start (now it has colors :D).

