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).

                                                  31 July 2024                                        riscemu(1)