This project contains a program to analyze Symbolics microcode files.
Version 0.1.0
Last Updated: 02-July-2018
The Symbolics Microcode Explorer is written in
Rust. The easiest way to get a Rust
environment set up is with the rustup
utility. See:
https://rustup.rs/
To build, just type:
cargo build # to build a debugging version
or
cargo build --release # to build a release version
Output will be in the directory uc-explorer/target/debug
or
uc-explorer/target/release
, depending on build type.
Symbolics Microcode Explorer is an interactive, command-driven program.
To start the program:
uc-explorer [-f <ucode_file>]
From there, you are presented with a prompt:
uc-explorer>
Valid commands are:
- help: Get a short help summary
- show: Show summary info about the microcode file
- load <filename>: Load a Microcode file
- dump <filename>: Disassemble and dump to a file
- quit: Quit the program
WARNING: The disassembly process produces around 4.5MB of output!
Plans on the horizon are:
- Full exploration of AMEM, BMEM, and CMEM using keystrokes to navigate between words.
- Better disassembly format.
Copyright 2017, Seth J. Morabito <web@loomcom.com>
This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this program. If not, see <https://www.gnu.org/licenses/>.