riscemu(1)

✨ riscemu — the vibe ✨

okay bestie, let me put you ON to riscemu, the RISC-V emulator written in Python, from the riscemu manual page (section 1, for all my command-line girlies 💅). no cap, this thing is giving "I run your RISC-V assembly and I look cute doing it."

---

🌸 NAME 🌸

riscemu — a RISC-V emulator in Python. that's it, that's the girl. 💖

---

🎀 SYNOPSIS 🎀

           [--stack_size [STACK_SIZE]] [--flen [FLEN]] [-v] [--interactive] [--ignore-exit-code]
           file.asm [file.asm ...]

---

🦋 DESCRIPTION 🦋

so like, what's inside this emulator? let me tell you, she ate:

• RISC-V Assembly parser — reads your asm, no drama
• RISC-V Assembly loader — loads it up, main character energy
• Emulation for most parts of the basic RISC-V instruction set and the M and A extensions — the classics, plus M and A
• Naive memory emulator — yes bestie, "naive" is literally her own word for it, I'm just the messenger 🙈
• Basic implementation of some syscalls — some. not all. set your expectations accordingly ✨
• A debugging environment — for when things go 💀 and you need answers

---

💅 OPTIONS 💅

• --strict-whitespace — do not treat all horizontal whitespace as equivalent. she's picky now. respect it. 💀
• --check-prefix — lets you change that default match keyword CHECK into literally any keyword you want. your keyword, your rules, periodt. 👑
• --implicit-check-not — adds an implicit CHECK-NOT check that works on every single input line. yes, every one. no lines escape the vibe check. 🫶
• --help — display available options ✨
• -h, --help — show this help message and exit 🎀
• --options OPTIONS, -o OPTIONS — toggle options! the available options are:
  • disable_debug — disable ebreak instructions
  • no_syscall_symbols — don't add symbols for SCALL_EXIT and others
  • fail_on_ex — if set, exceptions won't trigger the debugger (she's feral now 😭)
  • add_accept_imm — accept the "add rd, rs, imm" instruction (instead of addi). quoted exactly like that bestie, that's the literal instruction string.
  • unlimited_regs — allow an unlimited number of registers. infinity registers, zero consequences 🦋
  • libc — load a libc-like runtime (for malloc, etc.)
  • ignore_exit_code — don't exit with the program's exit code
• --syscall-opts SYSCALL_OPTS, -so SYSCALL_OPTS — syscall options, the -so shorty is right there for you 💖
• --instruction-sets INSTRUCTION_SETS, -is INSTRUCTION_SETS — which instruction sets to load! the available ones are: RV32I, RV32M, RV32A, RV32F, RV32D, Zicsr, RV_Debug. and plot twist: all of them are enabled by default. the whole menu, no upcharge. 🔥
• --stack_size [STACK_SIZE] — stack size of loaded programs, and it defaults to 8MB. big stack energy. 👑
• --flen [FLEN] — hardware FLEN, either 32 or 64. literal binary choice bestie, pick one. defaults to 64.
• -v, --verbose — verbosity level. and she's flexible — you can use it multiple times to go even more verbose. stack that -v. ⭐
• --interactive — launches the interactive debugger instantly instead of loading any programs. straight to the debugger, no programs, we goin' in raw. 💜
• --ignore-exit-code — ignore the exit code of the program and always return 0 if the program ran to completion. so 0 regardless. forgiving queen. 🧚

---

🐛 REPORTING BUGS 🐛

found a bug? (😭) please go visit the riscemu issues tracking system at:

they want to hear about it, fr fr. don't suffer in silence, bestie.

---

🌈 AUTHORS 🌈

this manual page was written by Bo YU <tsu.yubo@gmail.com> for the Debian project — but like, it may be used by others too. sharing is caring, iykyk. 🫶

---

legit reminder bb: the caveats in here are real. "naive memory emulator" and "some syscalls" are her actual words, so don't come for me when your weird syscall does a little nothing. that's canon. 💀

and that's the whole page! this was riscemu, manual page riscemu(1), dated 21 August 2025. slay, go emulate something iconic. 🎀✨👑