Symbolics 3640 Microcode Explorer
Find a file
2018-10-06 11:05:56 -07:00
docs Docs and ucode cleanup 2018-07-02 19:31:37 -07:00
src Update for Rustyline 2.1 2018-10-06 11:05:56 -07:00
.gitignore Add .idea to gitignore 2018-06-27 20:17:29 -07:00
Cargo.lock Update for Rustyline 2.1 2018-10-06 11:05:56 -07:00
Cargo.toml Update for Rustyline 2.1 2018-10-06 11:05:56 -07:00
COPYING Added GNU Public License 2018-06-27 17:44:42 +00:00
README.md Build summary in README 2018-07-02 08:29:46 -07:00

Symbolics Microcode Explorer

This project contains a program to analyze Symbolics microcode files.

History

Version 0.1.0

Last Updated: 02-July-2018

Compiling

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.

Usage

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!

TODO

Plans on the horizon are:

  1. Full exploration of AMEM, BMEM, and CMEM using keystrokes to navigate between words.
  2. Better disassembly format.

License

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/>.