Instruction
PSUBB
Subtracts packed bytes of MMX or XMM registers, wrapping around on overflow.
PSUBB subtracts the bytes of its second operand from those of its first
and keeps the low eight bits of each difference, so the result wraps
around, the same for signed and unsigned bytes, and no flag records a
borrow: 16 bytes in an XMM register, 8 in an MMX register. On Zen 5,
the recorded psubb xmm8, xmm15 turned 80h minus 01h into 7Fh (-128
minus 1 wrapping to 127), 7Fh minus FFh into 80h and 00h minus 01h into
FFh, and left bits 255:128 of the register as they were (see mixing
SSE and AVX). The subtractions that clamp
instead of wrapping are PSUBSB for signed and
PSUBUSB for unsigned bytes. PADDD
covers what the family’s legacy forms share.
Bytes in compiled code
In our builds at -O2 for the x86-64 baseline, over arrays of 1,024 bytes:
- Differences.
a[i] = b[i] - c[i]overuint8_tis one PSUBB per 16 bytes with the second operand from memory, in GCC 14 and Clang 23. - Negation. There is no negate:
-b[i]is PSUBB from a register zeroed with PXOR. - Constants.
b[i] - 'a'is not a subtraction at all: both add 9Fh, the negated constant, with PADDB. - Bit counts. Clang vectorizes
__builtin_popcountof each byte with the classic first step,x - ((x >> 1) & 55h): there is no byte shift, so it shifts words with PSRLW, lets the PAND drop the bits that crossed from the neighbouring byte, and subtracts with PSUBB, then sums pairs and nibbles with PADDB. GCC calls the library’s__popcountdi2for every byte. With-march=x86-64-v2, Clang looks the count of each nibble up with PSHUFB instead, and GCC uses the scalar POPCNT.
A register minus itself is zero: the recorded psubb mm3, mm3 cleared
MM3 whatever it held. Intel’s optimization manual lists PSUBB of an XMM
register with itself among the idioms that break the dependency on the
old value (Section 3.5.1.7); which cores take the legacy form so, the
guide’s zeroing idioms section
covers. Compilers zero with PXOR.
AMD’s latency spreadsheet for Zen 5 gives PSUBB one cycle, four per cycle. The MMX form came with MMX and the XMM form with SSE2, whose memory operand must be aligned to 16 bytes. VPSUBB is the VEX and EVEX form; PSUBW, PSUBD and PSUBQ take wider elements.
Forms
Data flow
Where the elements of the sources go, element 0 on the right; results that depend on a control value are drawn for an example. How to read.
Shown: bytes 7 to 0. Every byte works alike: 8 and 16 bytes in the mm and xmm forms.
Result byte i comes from byte i of xmm1 and xmm2. Result bytes 7 to 0: a7-b7, a6-b6, a5-b5, a4-b4, a3-b3, a2-b2, a1-b1, a0-b0.
Operation
What the forms do, in pseudocode that our tests run against results recorded on real processors. How to read.
PSUBB mm, mm/m64for i in range(8):
mm1.b[i] = mm1.b[i] - src2.b[i]
# x87: TOP = 0, all tags valid, bits 79:64 of mm1's register all onesRun on AMD Zen 5 (EPYC 9645): 2 cases.
PSUBB xmm, xmm/m128for i in range(16):
xmm1.b[i] = xmm1.b[i] - src2.b[i]
# bits 128 and up of the register are unchangedRun on AMD Zen 5 (EPYC 9645): 2 cases.
Operands
| Operand | Kind | Action |
|---|---|---|
PSUBB mm, mm/m64 | ||
mm | explicit | read, write |
mm/m64 | explicit | read |
PSUBB xmm, xmm/m128 | ||
xmm | explicit | read, write |
xmm/m128 | explicit | read |
Flags
None: XED records no flag that the forms test or change.
Exceptions
The exception class is XED's name for the set of exception conditions that a form follows. How to read.
Attributes
What else XED records about the forms. How to read.
PSUBB mm, mm/m64- may abort a TSX transaction
PSUBB xmm, m128- aligned memory operand
Intrinsics
The C intrinsics of Clang 23.1.2 that compile to PSUBB, each with the form it compiles to and the Clang options it needs. The forms come from compiling every intrinsic and decoding the result with Intel XED; all intrinsics A–Z explains the method.
| Intrinsic | Compiles to |
|---|---|
_mm_sub_epi8
__m128i _mm_sub_epi8(__m128i __a, __m128i __b) |
|
_mm_sub_pi8
__m64 _mm_sub_pi8(__m64 __m1, __m64 __m2) |
|
CPUID and processors
Each form belongs to an XED ISA set. A form can be used when the processor reports every CPUID bit of one of its ISA set's alternatives.
More MMX instructions
- PADDB
- PADDD
- PADDSB
- PADDSW
- PADDUSB
- PADDUSW
- PADDW
- PAND
- PANDN
- PCMPEQB
- PCMPEQD
- PCMPEQW
- PCMPGTB
- PCMPGTD
- PCMPGTW
- PMADDWD
- PMULHW
- PMULLW
- POR
- PSLLD
- PSLLQ
- PSLLW
- PSRAD
- PSRAW
- PSRLD
- PSRLQ
- PSRLW
- PSUBD
- PSUBSB
- PSUBSW
- PSUBUSB
- PSUBUSW
- PSUBW
- PUNPCKHBW
- PUNPCKHDQ
- PUNPCKHWD
- PUNPCKLBW
- PUNPCKLDQ
- PUNPCKLWD
- PXOR
More SSE2 instructions
Sources
- Intel XED v2026.08.23 (commit
0bcb6237345c): forms, encodings, operands, flags, exception classes, attributes, ISA sets, CPUID bits and chip model. - The CPU data of x86-64.net: Zen 3 to Zen 6, from GCC’s
-marchfeature sets and AMD’s Processor Programming References, which the page of each processor cites. - Clang's x86 intrinsic headers, LLVM 23.1.2 (commit
85ac56026243): the intrinsics, their signatures and doc comments, and the Clang of that release, which compiled each of them. - Intel 64 and IA-32 Architectures Software Developer's Manual, Volume 2 (325383-093, September 2026): Volume 2B, page 4-479 (PSUBB/
PSUBW/ PSUBD) - Intel 64 and IA-32 Architectures Software Developer's Manual, Volume 1 (253665-093, September 2026)
- Intel 64 and IA-32 Architectures Optimization Reference Manual, Volume 1 (248966-051, October 2026)
- Software Optimization Guide for the AMD Zen5 Microarchitecture (58455, rev. 1.00, August 2024), Wayback Machine copy of AMD's ZIP
The tables are derived from Intel XED, Copyright Intel Corporation, licensed under the Apache License 2.0; x86-64.net converted and reformatted them. The intrinsics and their signatures come from Clang, part of the LLVM Project, licensed under the Apache License 2.0 with LLVM Exceptions. The text is our own.