[binutils-gdb] s390: Document PC-relative immediate operands in instruction formats

Jens Remus jremus@sourceware.org
Tue Nov 10 16:48:17 GMT 2026


https://sourceware.org/git/gitweb.cgi?p=binutils-gdb.git;h=3bf541887059e1d19f4d592fff0728ec22e7a952

commit 3bf541887059e1d19f4d592fff0728ec22e7a952
Author: Jens Remus <jremus@linux.ibm.com>
Date:   Tue Nov 10 17:46:02 2026 +0100

    s390: Document PC-relative immediate operands in instruction formats
    
    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>

Diff:
---
 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 38d610bd04e..a0c7d085ebf 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


More information about the Binutils-cvs mailing list