NAME

       riscemu - RISC-V emulator in Python.

SYNOPSIS

        riscemu [-h] [--options OPTIONS] [--syscall-opts SYSCALL_OPTS] [--instruction-sets INSTRUCTION_SETS]
                   [--stack_size [STACK_SIZE]] [--flen [FLEN]] [-v] [--interactive] [--ignore-exit-code]
                   file.asm [file.asm ...]

DESCRIPTION

       This emulator contains:

              -      RISC-V Assembly parser

              -      RISC-V Assembly loader

              -      Emulation for most parts of the basic RISC-V instruction set and the M and A
                     extensions

              -      Naive memory emulator

              -      Basic implementation of some syscalls

              -      A debugging environment

OPTIONS

       --strict-whitespace
              - Do not treat all horizontal whitespace as equivalent

       --check-prefix
              - Allows changing a default match keyword CHECK to an arbitrary keyword

       --implicit-check-not
              - Adds implicit CHECK-NOT check that works on every input line

       --help - Display available options

       -h, --help
              show this help message and exit  --options  OPTIONS,  -o  OPTIONS  Toggle  options.
              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

              add_accept_imm:
                     Accept "add rd, rs, imm" instruction (instead of addi)

              unlimited_regs:
                     Allow an unlimited number of registers

              libc:  Load a libc-like runtime (for malloc, etc.)

              ignore_exit_code:
                     Don't  exit  with  the programs exit code.  --syscall-opts SYSCALL_OPTS, -so
                     SYSCALL_OPTS  --instruction-sets  INSTRUCTION_SETS,   -is   INSTRUCTION_SETS
                     Instruction  sets to load, available are: RV32I, RV32M, RV32A, RV32F, RV32D,
                     Zicsr, RV_Debug.  All are enabled by default --stack_size [STACK_SIZE] Stack
                     size of loaded programs, defaults to 8MB

       --flen [FLEN]
              hardware FLEN, either 32 or 64. Defaults to 64

       -v, --verbose
              Verbosity level (can be used multiple times)

       --interactive
              Launch the interactive debugger instantly instead of loading any programs

       --ignore-exit-code
              Ignore  exit  code  of  the  program  and  always  return  0  if the program ran to
              completion.

REPORTING BUGS

       To   report   a   bug    please    visit    riscemu    issues    tracking    system    at:
       https://github.com/AntonLydike/riscemu/issues

AUTHORS

       This manual page was written by Bo YU <tsu.yubo@gmail.com> for the Debian project (but may
       be used by others).