qtrvsim_cli - RISC-V CPU simulator for education
qtrvsim_cli [options] FILE
QtRvSim CLI machine simulator
- -h, --help
- Displays help on commandline options.
- --help-all
- Displays help including Qt specific options.
- -v, --version
- Displays version information.
- --asm
- Treat provided file argument as assembler source.
- --pipelined
- Configure CPU to use five stage pipeline.
- --no-delay-slot
- Disable jump delay slot.
- --hazard-unit
<HUKIND>
- Specify hazard unit implementation [none|stall|forward].
- --trace-fetch,
--tr-fetch
- Trace fetched instruction (for both pipelined and not core).
- --trace-decode,
--tr-decode
- Trace instruction in decode stage. (only for pipelined core)
- --trace-execute,
--tr-execute
- Trace instruction in execute stage. (only for pipelined core)
- --trace-memory,
--tr-memory
- Trace instruction in memory stage. (only for pipelined core)
- --trace-writeback,
--tr-writeback
- Trace instruction in write back stage. (only for pipelined core)
- --trace-pc,
--tr-pc
- Print program counter register changes.
- --trace-wrmem,
--tr-wr
- Trace writes into memory.
- --trace-rdmem,
--tr-rd
- Trace reads from memory.
- --trace-gp,
--tr-gp <REG>
- Print general purpose register changes. You can use * for all
registers.
- --dump-to-json
<FNAME>
- Configure reportor dump to json file.
- --dump-registers,
--d-regs
- Dump registers state at program exit.
- --dump-cache-stats
- Dump cache statistics at program exit.
- --dump-cycles
- Dump number of CPU cycles till program end.
- --dump-range
<START,LENGTH,FNAME>
- Dump memory range.
- --load-range
<START,FNAME>
- Load memory range.
- --expect-fail
- Expect that program causes CPU trap and fail if it doesn't.
- --fail-match
<TRAP>
- 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.
Using this implies expect-fail option.
- --d-cache
<DCACHE>
- Data cache. Format policy,sets,words_in_blocks,associativity where policy
is random/lru/lfu
- --i-cache
<ICACHE>
- Instruction cache. Format policy,sets,words_in_blocks,associativity where
policy is random/lru/lfu
- --l2-cache
<L2CACHE>
- L2 cache. Format policy,sets,words_in_blocks,associativity where policy is
random/lru/lfu
- --read-time
<RTIME>
- Memory read access time (cycles).
- --write-time
<WTIME>
- Memory read access time (cycles).
- --burst-time
<BTIME>
- Memory read access time (cycles).
- --serial-in,
--serin <FNAME>
- File connected to the serial port input.
- --serial-out,
--serout <FNAME>
- File connected to the serial port output.
- --os-emulation,
--osemu
- Operating system emulation.
- --std-out,
--stdout <FNAME>
- File connected to the syscall standard output.
- --os-fs-root,
--osfsroot <DIR>
- Emulated system root/prefix for opened files
- --isa-variant,
--isavariant <STR>
- Instruction set to emulate (default RV32IMA)
- --cycle-limit
<NUMBER>
- Limit execution to specified maximum clock cycles
- FILE
- Input ELF executable file or assembler source
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, the command
- info qtrvsim_cli
should give you access to the complete manual.