QTRVSIM_CLI(1)

📦
version 0.9.8 · 2 versions
, in ubuntu resolute, ubuntu stonking

✨ QTRVSIM_CLI ✨

okay so bestie, gather round, because we're talking about qtrvsim_cli from the QTRVSIM_CLI(1) manual — a RISC-V CPU simulator for education and honestly? she's iconic. 💅

🌸 SYNOPSIS 🌸

qtrvsim_cli [options] FILE

💖 DESCRIPTION 💖

QtRvSim CLI machine simulator. that's it, that's the whole vibe — a whole CPU simulator you drive from the terminal like the main character you are. 👑

✨ OPTIONS ✨

  • -h, --help — shows you the help for the commandline options. your little cheat sheet, bestie 🫶
  • --help-all — same energy but it also shows the Qt-specific options. more lore. 🌈
  • -v, --version — tells you the version info. which one are we on? we'll get to that at the end 👀
  • --asm — treats the file argument you gave as assembler source. 📝
  • --pipelined — sets the CPU up to use the five stage pipeline. pipeline girlies rise 🔥
  • --no-delay-slot — disables the jump delay slot. sorry to the delay slot, she's out ✋
  • --hazard-unit <HUKIND> — picks which hazard unit implementation you want: none, stall, or forward. ⚠️ choose wisely
  • --trace-fetch, --tr-fetch — traces the fetched instruction (works for both the pipelined core and the not-pipelined one). 🔍
  • --trace-decode, --tr-decode — traces the instruction in the decode stage. (only for the pipelined core, just so you know)
  • --trace-execute, --tr-execute — traces the instruction in the execute stage. (only for the pipelined core)
  • --trace-memory, --tr-memory — traces the instruction in the memory stage. (only for the pipelined core)
  • --trace-writeback, --tr-writeback — traces the instruction in the write back stage. (only for the pipelined core)
  • --trace-pc, --tr-pc — prints the program counter register changes. she's moving, she's moving 📍
  • --trace-wrmem, --tr-wr — traces the writes going into memory. ✍️
  • --trace-rdmem, --tr-rd — traces the reads coming from memory. 📖
  • --trace-gp, --tr-gp <REG> — prints the general purpose register changes. and here's the slay: you can use * to get all the registers. 🌟
  • --dump-to-json <FNAME> — sets up the reporter to dump to a json file. 💾
  • --dump-registers, --d-regs — dumps the register state when the program exits. bye, here's my whole vibe, in registers 💀
  • --dump-cache-stats — dumps the cache statistics when the program exits. 📊
  • --dump-cycles — dumps how many CPU cycles it took until the program ended. ⏱️
  • --dump-range <START,LENGTH,FNAME> — dumps a memory range. 🧠
  • --load-range <START,FNAME> — loads a memory range. 📥
  • --expect-fail — expects the program to cause a CPU trap, and if it doesn't, that's a fail. expectation management, but make it hardware 🫠
  • --fail-match <TRAP> — the program should exit with exactly this CPU TRAP. possible values are I (unsupported Instruction), A (Unsupported ALU operation), O (Overflow/underflow) and J (Unaligned Jump). you can freely combine them, no cap. and just so we're clear: using this implies the expect-fail option. ⚠️
  • --d-cache <DCACHE> — the data cache. format is policy,sets,words_in_blocks,associativity where the policy is random/lru/lfu. 🍓
  • --i-cache <ICACHE> — the instruction cache. format is policy,sets,words_in_blocks,associativity where the policy is random/lru/lfu. 🎀
  • --l2-cache <L2CACHE> — the L2 cache. format is policy,sets,words_in_blocks,associativity where the policy is random/lru/lfu. 🧚
  • --read-time <RTIME> — memory read access time, in cycles. ⏳
  • --write-time <WTIME> — memory read access time, in cycles. (yes bestie it literally says read, we're keeping it exactly as written 🙈)
  • --burst-time <BTIME> — memory read access time, in cycles. (same situation, word for word, we don't edit the ancestors 💜)
  • --serial-in, --serin <FNAME> — the file connected to the serial port input. 🔌
  • --serial-out, --serout <FNAME> — the file connected to the serial port output. 🔌
  • --os-emulation, --osemu — operating system emulation. we're running a whole OS in here, lowkey 💻
  • --std-out, --stdout <FNAME> — the file connected to the syscall standard output. 📤
  • --os-fs-root, --osfsroot <DIR> — the emulated system root/prefix for opened files. 🗂️
  • --isa-variant, --isavariant <STR> — which instruction set to emulate. default is RV32IMA. 🌟
  • --cycle-limit <NUMBER> — limits the execution to the specified maximum clock cycles. put a cap on it 🧢

🦋 Arguments 🦋

  • FILE — the input ELF executable file or assembler source. this is your moment, feed her the file 📁

🔥 SEE ALSO 🔥

the full documentation for qtrvsim_cli is maintained as a Texinfo manual. if the info and qtrvsim_cli programs are properly installed at your site, then this command:

info qtrvsim_cli

should give you access to the complete manual. go read her, she ate 💅

and that's a wrap, bestie!! 🎀 this whole thing is qtrvsim_cli 0.9.8, and the manual page is from January 2026. slay, stan, simulate ⭐🦋💖

📦 where this page comes from