binutils Newspaper
OCTOBER 6, 2026
s390 — Proposed

s390: Add .insn pseudo-mnemonics rie_a/b/c/d/e/f/g

Adds gas test cases and support for various RIE instruction formats on s390.

This patch introduces support for seven variations of the RIE (Register and Index Extension) instruction format in the s390 GNU Assembler (gas), denoted by pseudo-mnemonics rie_a through rie_g. It updates opcode definitions with specific instruction formats and operand ordering, and adds corresponding tests to the gas test suite to ensure correct assembly and disassembly for different hardware generations.

In the Thread 1 participant
  1. Jens Remus <jremus@linux.ibm.com> proposer

    Submits patches to add support for RIE pseudo-mnemonics (rie_a to rie_g) to the s390 gas assembler, detailing their history and requirements.

    “History of instruction format RIE: - RIE-e got initially introduced as RIE with IBM z900. [1, 2] - RIE-a/b/c and RIE-f got introduced with IBM z10. [3] - RIE-d got introduced with IBM z196. [4] - RIE-g got introduced with IBM z13. [5]”

In Details

This patch adds support for RIE instruction formats (Register and Index Extension) to the s390 GNU Assembler (gas) via pseudo-mnemonics 'rie_a' through 'rie_g'. It defines specific instruction formats and operand orders in opcodes/s390-opc.c and adds tests to gas/testsuite/gas/s390/zarch-operands.d/s to cover the evolution of RIE formats across different IBM mainframe architectures (z900, z10, z196, z13).

For Context
RIE
Register and Index Extension, a type of instruction format in IBM s/390 architectures that uses registers for addressing and index components, with variations introduced over different hardware generations.
pseudo-mnemonic
An assembly language construct that resembles a machine instruction but is processed by the assembler to generate one or more actual machine instructions or to represent a complex instruction format.
.insn
A GNU Assembler directive that allows embedding raw machine instructions or pseudo-mnemonics, useful for testing or specific instruction generation.
Filed Under: s390gastestsinstructionsassembler