binutils Newspaper
OCTOBER 6, 2026
s390 — Proposed

s390: Make M3 operand optional in .insn pseudo-mnemonic vrx

Make the M3 operand optional for s390 .insn vrx pseudo-mnemonic.

This patch makes the M3 mask operand optional for the ‘.insn vrx’ pseudo-mnemonic in the s390 gas assembler. It updates the opcode definitions, documentation, and adds test cases for this instruction format.

In Details

This patch modifies the s390 GNU Assembler (gas) to support an optional M3 mask field in the VRX instruction format, accessible via the '.insn vrx' pseudo-mnemonic. Changes include updating opcodes/s390-opc.c, gas/doc/c-s390.texi to reflect the optionality (denoted by '[M3]'), and adding new test cases in gas/testsuite/gas/s390/zarch-operands.d/.s.

For Context
.insn
A GNU assembler directive that allows embedding raw instruction bytes or defining pseudo-mnemonics for specific instruction formats.
pseudo-mnemonic
An assembly language construct that represents a machine instruction, potentially with operands that are not direct encodings of machine code but are processed by the assembler.
operand
A value or symbol that an instruction operates on.
VRX
A specific instruction format in the s390 architecture.
Filed Under: s390gas.insninstruction-format