[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