binutils Newspaper
OCTOBER 12, 2026
s390 — Proposed

s390: Complete .insn pseudo-mnemonics

Adds all s390 instruction formats to .insn pseudo-mnemonics and improves documentation.

This series completes the .insn pseudo-mnemonics for all s390 instruction formats and their variants, documenting their operand order according to the z/Architecture Principles of Operations manual. It also enhances the documentation for the .insn directive itself. The changes aim to provide a more complete and accurate way to specify instructions using pseudo-mnemonics in assembly code.

In Details

This patch series adds comprehensive support for s390 instruction formats via the .insn pseudo-mnemonic in GNU as. It defines operand orderings for various instruction formats (e.g., RSL-b) based on the Principles of Operations manual, handling register, immediate, and composite operands. This impacts how users can express complex or less common s390 instructions in assembly, ensuring consistency with the architecture specification.

For Context
.insn
A GNU assembler (gas) pseudo-mnemonic that allows specifying machine instructions directly, often with operands defined by fields like R#, D#, B#, M#, etc.
pseudo-mnemonic
An assembly language construct that represents a machine instruction but is not a direct opcode; it's a directive to the assembler.
z/Architecture Principles of Operations
The official manual detailing the instruction set architecture, instruction formats, and operational behavior of IBM's z/Architecture mainframe processors.
Filed Under: s390assemblerdocumentationinstruction format