binutils Newspaper
OCTOBER 6, 2026
s390 — Proposed

s390: Add .insn pseudo-mnemonic smi

Adds support for the SMI instruction format via the .insn pseudo-mnemonic in the s390 assembler.

This patch introduces support for the SMI instruction format, which was introduced with the IBM zEC12 processor, into the s390 assembler using the .insn pseudo-mnemonic. It requires the respective minimum architecture or CPU level. The changes involve adding the format to s390-opc.c, documenting it in gas/doc/c-s390.texi, and adding corresponding tests in the gas testsuite.

In Details

This patch adds a new pseudo-mnemonic, smi, to the s390 assembler's .insn directive support, located in opcodes/s390-opc.c. The SMI format is a machine instruction format introduced in the IBM zEC12. The change ensures that the assembler can correctly encode and generate machine code for instructions using this format, requiring that the target architecture meets the zEC12 level or higher. Documentation in gas/doc/c-s390.texi and new test cases are included.

For Context
.insn
An assembler pseudo-mnemonic that allows embedding raw machine instructions using their format and opcode.
pseudo-mnemonic
An assembler directive that represents a machine instruction or a sequence of instructions using a symbolic name.
s390
IBM's mainframe and enterprise server architecture.
zEC12
IBM zEnterprise EC12, a specific model of IBM's mainframe processors.
SMI format
A specific instruction encoding format for the s390 architecture, introduced with the zEC12.
Filed Under: binutilsgass390assemblerinstruction format