[PATCH v2 06/47] s390: Document PC-relative immediate operands in instruction formats
Jens Remus
jremus@linux.ibm.com
Fri Nov 6 15:56:56 GMT 2026
Instruction formats RIE, RIL, and RSI have a signed PC-relative
immediate operand. [1] Represent those as "RIx" (relative immediate)
in the documented instruction formats.
[1]: IBM z/Architecture Principles of Operation, SA22-7832-14, IBM z17,
https://www.ibm.com/docs/en/module_1678991624569/pdf/SA22-7832-14.pdf
gas/
* doc/c-s390.texi (RIE, RIL, RSI): Immediate operand is
PC-relative.
Signed-off-by: Jens Remus <jremus@linux.ibm.com>
---
gas/doc/c-s390.texi | 13 +++++++------
1 file changed, 7 insertions(+), 6 deletions(-)
diff --git a/gas/doc/c-s390.texi b/gas/doc/c-s390.texi
index 38d610bd04e7..a0c7d085ebf6 100644
--- a/gas/doc/c-s390.texi
+++ b/gas/doc/c-s390.texi
@@ -341,6 +341,7 @@ instruction formats:
@item Vx @tab Vector register number for operand x.
@item Ix @tab Signed immediate for operand x.
@item Ux @tab Unsigned immediate for operand x.
+@item RIx @tab Signed PC-relative immediate for operand x.
@end multitable
@end display
@@ -389,18 +390,18 @@ with the @samp{.insn} pseudo directive:
0 8 12 16 31
@end verbatim
-@item RIE format: <insn> R1,R3,I2
+@item RIE format: <insn> R1,R3,RI2
@verbatim
+---------+----+----+-------------------+---------+---------+
-| OpCode | R1 | R3 | I2 |/////////| OpCode |
+| OpCode | R1 | R3 | RI2 |/////////| OpCode |
+---------+----+----+-------------------+---------+---------+
0 8 12 16 32 40 47
@end verbatim
-@item RIL format: <insn> R1,I2
+@item RIL format: <insn> R1,RI2
@verbatim
+---------+----+----+---------------------------------------+
-| OpCode | R1 |OpCd| I2 |
+| OpCode | R1 |OpCd| RI2 |
+---------+----+----+---------------------------------------+
0 8 12 16 47
@end verbatim
@@ -469,10 +470,10 @@ with the @samp{.insn} pseudo directive:
0 8 12 16 20 32 40 47
@end verbatim
-@item RSI format: <insn> R1,R3,I2
+@item RSI format: <insn> R1,R3,RI2
@verbatim
+---------+----+----+-------------------+
-| OpCode | R1 | R3 | I2 |
+| OpCode | R1 | R3 | RI2 |
+---------+----+----+-------------------+
0 8 12 16 31
@end verbatim
--
2.53.0
More information about the Binutils
mailing list