]> git.ipfire.org Git - thirdparty/binutils-gdb.git/commitdiff
doc/riscv: Add description of disassembler options
authorMarek Pikuła <m.pikula@partner.samsung.com>
Thu, 27 Mar 2025 14:09:14 +0000 (15:09 +0100)
committerNelson Chu <nelson@rivosinc.com>
Fri, 28 Mar 2025 01:20:41 +0000 (09:20 +0800)
Up to this point, no mention of RISC-V-specific disassembler options was
mentioned in binutils documentation. This patch includes description for
all of the currently supported options.

Signed-off-by: Marek Pikuła <m.pikula@partner.samsung.com>
binutils/doc/binutils.texi

index 73848e3b390dc9ce60f1eb86318078460e0e259b..5bf5d80b85b2c9b5851c38daf6751185be1b4065 100644 (file)
@@ -2701,6 +2701,23 @@ If you disassemble without giving a CPU selection, a default will be
 chosen from information gleaned by BFD from the object files headers,
 but the result again may not be as you expect.
 
+For RISC-V, the following options are supported:
+
+@table @code
+@item numeric
+Print numeric register names, rather than ABI names (e.g., print @code{x2}
+instead of @code{sp}).
+
+@item no-aliases
+Disassemble only into canonical instructions. For example, compressed
+instructions will be represented as such (@code{addi sp,sp,-128} will be
+@code{c.addi16sp sp,-128}).
+
+@item priv-spec=@var{SPEC}
+Print the CSR according to the chosen privilege spec version (e.g.,
+@code{1.10}, @code{1.11}, @code{1.12}).
+@end table
+
 For MIPS, this option controls the printing of instruction mnemonic
 names and register names in disassembled instructions.  Multiple
 selections from the following may be specified as a comma separated