rachel (pronounced 'rayshell') - a collection of Bash macros adding some MASM spice to your bland shell sessions.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
 
Sam Hunter ecc61bdfac Merge branch 'master' of https://git.rawtext.club/samhunter/rachel 4 months ago
examples Cleanup. 5 months ago
rachel help for basic commandline dot-commands added. 4 months ago
LICENSE Initial commit 5 months ago
README.md minor edit 4 months ago
_rachelrc Initial commit. 5 months ago
rachel.sh Initial commit. 5 months ago
rachel_screen.png Picture added. 5 months ago

README.md

rachel

rachel (pronounced 'rayshell' - a collection of Bash macros adding some MASM spice to your bland shell sessions.

rachel monitor

MASM simulator/interpreter in Bash

A modular, just for fun and experimenting implementation of MASM-like assembly language in Bash (5 and above, I have no ambition to make it POSIX-compliant). As everything is a Bash function it is possible to intermix the "assembly" with Bash (only interactively, the functions aren't visible to bash scripts)

What's inside

  • a reasonable subset of x86 assembly language in Intel notation
  • registers (32-bit equiv., but I am using AX, BX, CX, DX instead of the 32-bit E[ABCD]X notation)
  • flags/FLAGS register
  • a simple debugger/stepwise execution
  • stack and register visualisations in multiple formats
  • memory visualisation
  • fancy listings
  • some Irvine functions
  • integration with Bash
  • dump/restore of the state (memory/registers/pointers)
  • some examples/testcases

What's not inside

  • speed
  • binary executable or relocatables
  • real memory access (it's just a big Bash array)
  • IRQs/syscalls
  • good documentation... not yet at least