Instruction
VPSUBB
Subtracts packed bytes, wrapping around on overflow.
VPSUBB subtracts the bytes of its second source from those of its
first and keeps the low eight bits of each difference, wrapping around
with no flags: the VEX and EVEX form of PSUBB, whose
page covers negation, constants and other uses. The newer encodings
bring what VPADDB lists: a separate destination,
memory at any alignment, zeroing above the vector length, AVX for
VEX.128 and AVX2 for VEX.256, and EVEX forms that need AVX512BW (or
AVX10.1), take a mask bit per byte and cannot broadcast. On Zen 5,
vpsubb xmm8, xmm15, xmm0 turned 00h minus 01h into FFh, 80h minus
01h into 7Fh and 7Fh minus FFh into 80h.
Zero and masks
A register minus itself is zero whatever it held: the recorded vpsubb ymm4, ymm4, ymm4 cleared all of ZMM4. AMD’s Zen 5 guide lists VPSUBB
of a register from itself, at every width, among the zeroing idioms
that take no cycle and do not wait for the old value (Section 2.9.2);
Intel’s optimization manual names the xmm and unmasked zmm forms
(Section 3.5.1.7). In our builds at -O2, _mm256_sub_epi8(a, a) is
VPXOR in GCC 14 and VXORPS in Clang 23.
With -march=x86-64-v4, GCC uses masks for conditional differences
of uint8_t arrays in our builds:
- Absolute differences.
b[i] > c[i] ? b[i] - c[i] : c[i] - b[i]is VPCMPUB (as VPCMPNLEUB) into k1, VPSUBB forc - b, and a second VPSUBB under k1 that mergesb - cinto the bytes wherebis greater. Clang subtracts VPMINUB from VPMAXUB instead, at-v3and-v4. - Differences that stop at zero.
b[i] > c[i] ? b[i] - c[i] : 0is the same compare and one VPSUBB with zeroing, where Clang emits VPSUBUSB.
AMD’s latency spreadsheet for Zen 5 gives the VEX and EVEX rows alike one cycle and four per cycle on any of pipes FP0 to FP3.
Forms
| Instruction | Encoding | Requires |
|---|---|---|
VPSUBB xmm, xmm, m128
VPSUBB_XMMdq_XMMdq_MEMdq | VEX.128.66.0F.WIG F8 /r | AVX |
VPSUBB xmm, xmm, xmm
VPSUBB_XMMdq_XMMdq_XMMdq | VEX.128.66.0F.WIG F8 /r | AVX |
VPSUBB ymm, ymm, m256
VPSUBB_YMMqq_YMMqq_MEMqq | VEX.256.66.0F.WIG F8 /r | AVX2 |
VPSUBB ymm, ymm, ymm
VPSUBB_YMMqq_YMMqq_YMMqq | VEX.256.66.0F.WIG F8 /r | AVX2 |
VPSUBB xmm {k}{z}, xmm, xmm
VPSUBB_XMMu8_MASKmskw_XMMu8_XMMu8_AVX512 | EVEX.128.66.0F.WIG F8 /r | AVX10.1 or AVX512BW + AVX512VL |
VPSUBB xmm {k}{z}, xmm, m128
VPSUBB_XMMu8_MASKmskw_XMMu8_MEMu8_AVX512 | EVEX.128.66.0F.WIG F8 /r | AVX10.1 or AVX512BW + AVX512VL |
VPSUBB ymm {k}{z}, ymm, ymm
VPSUBB_YMMu8_MASKmskw_YMMu8_YMMu8_AVX512 | EVEX.256.66.0F.WIG F8 /r | AVX10.1 or AVX512BW + AVX512VL |
VPSUBB ymm {k}{z}, ymm, m256
VPSUBB_YMMu8_MASKmskw_YMMu8_MEMu8_AVX512 | EVEX.256.66.0F.WIG F8 /r | AVX10.1 or AVX512BW + AVX512VL |
VPSUBB zmm {k}{z}, zmm, zmm
VPSUBB_ZMMu8_MASKmskw_ZMMu8_ZMMu8_AVX512 | EVEX.512.66.0F.WIG F8 /r | AVX10.1 or AVX512BW |
VPSUBB zmm {k}{z}, zmm, m512
VPSUBB_ZMMu8_MASKmskw_ZMMu8_MEMu8_AVX512 | EVEX.512.66.0F.WIG F8 /r | AVX10.1 or AVX512BW |
Latency and throughput
| Model | xmm, xmm, m128xmm {k}{z}, xmm, m128no mask | xmm, xmm, xmmxmm {k}{z}, xmm, xmmno maskymm {k}{z}, ymm, ymmno mask | ymm, ymm, m256ymm {k}{z}, ymm, m256no mask | ymm, ymm, ymm | xmm {k}{z}, xmm, xmmwith a mask, zeroingymm {k}{z}, ymm, ymmwith a mask, zeroing | xmm {k}{z}, xmm, m128with a mask, zeroing | ymm {k}{z}, ymm, m256with a mask, zeroing | zmm {k}{z}, zmm, zmmno mask | zmm {k}{z}, zmm, zmmwith a mask, zeroing | zmm {k}{z}, zmm, m512no mask | zmm {k}{z}, zmm, m512with a mask, zeroing |
|---|---|---|---|---|---|---|---|---|---|---|---|
| Sandy Bridge | 7 / 0.5p15 | 1 / 0.5p15 | |||||||||
| Haswell | 7 / 0.5p15 | 1 / 0.5p15 | 8 / 0.5p15 | 1 / 0.5p15 | |||||||
| Broadwell | 6 / 0.5p15 | 1 / 0.5p15 | 7 / 0.5p15 | 1 / 0.5p15 | |||||||
| Skylake | 7 / 0.5p015 | 1 / 0.33p015 | 8 / 0.5p015 | 1 / 0.33p015 | |||||||
| Skylake-SP, Ice Lake | 7 / 0.5p015 | 1 / 0.33p015 | 8 / 0.5p015 | 1 / 0.33p015 | 1 / 0.33p015 | 7 / 0.5p015 | 8 / 0.5p015 | 1 / 0.33p015 | 1 / 0.33p015 | 8 / 0.5p015 | 8 / 0.5p015 |
| Alder Lake | 8 / 0.33p015 | 1 / 0.33p015 | 9 / 0.33p015 | 1 / 0.33p015 | |||||||
| Sapphire Rapids | 8 / 0.33p015 | 1 / 0.33p015 | 9 / 0.33p015 | 1 / 0.33p015 | 3 / 0.33p015 | 11 / 0.33p015 | 11 / 0.33p015 | 1 / 0.5p05 | 3 / 0.5p05 | 9 / 0.5p05 | 11 / 0.5p05 |
| Lunar Lake | 7 / 2V0 V1 V2 V3 | 1 / 0.25V0 V1 V2 V3 | 8 / 2.33V0 V1 V2 V3 | 1 / 0.25V0 V1 V2 V3 | |||||||
| Piledriver | 7 / 1.5FPMAL | 2 / 0.5FPMAL FPU2 FPU3 | |||||||||
| Zen | 8 / 0.5FPU0 FPU1 FPU3 | 1 / 0.33FPU0 FPU1 FPU3 | 8 / 0.67FPU0 FPU1 FPU3 | 1 / 0.67FPU0 FPU1 FPU3 | |||||||
| Zen 2 | 8 / 0.33FPU0 FPU1 FPU3 | 1 / 0.33FPU0 FPU1 FPU3 | 8 / 0.33FPU0 FPU1 FPU3 | 1 / 0.33FPU0 FPU1 FPU3 | |||||||
| Zen 3 | 8 / 0.5FP0 FP1 FP2 FP3 | 1 / 0.25FP0 FP1 FP2 FP3 | 8 / 0.5FP0 FP1 FP2 FP3 | 1 / 0.25FP0 FP1 FP2 FP3 | |||||||
| Zen 4 | 8 / 0.5FP0 FP1 FP2 FP3 | 1 / 0.25FP0 FP1 FP2 FP3 | 8 / 0.5FP0 FP1 FP2 FP3 | 1 / 0.25FP0 FP1 FP2 FP3 | 1 / 0.25FP0 FP1 FP2 FP3 | 8 / 0.5FP0 FP1 FP2 FP3 | 8 / 0.5FP0 FP1 FP2 FP3 | 1 / 0.25FP0 FP1 FP2 FP3 | 1 / 0.5FP0 FP1 FP2 FP3 | 8 / 0.5FP0 FP1 FP2 FP3 | 8 / 0.5FP0 FP1 FP2 FP3 |
| Jaguar | 6 / 1FPU0 FPU1 VALU0 VALU1 | 1 / 0.5FPU0 FPU1 VALU0 VALU1 | |||||||||
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: 16, 32 and 64 bytes in the xmm, ymm and zmm forms. The EVEX forms write under a mask: where its bit is 0, the element keeps its old value, or zeroes it with {z}.
Result byte i comes from byte i of xmm2 and xmm3. Result bytes 7 to 0: a7-b7, unchanged (bit 6 of k1 is 0), 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.
for i in range(VL // 8):
if k1[i]: # 1 without a write mask
zmm1.b[i] = zmm2.b[i] - src3.b[i]
elif zeroing:
zmm1.b[i] = 0
# else: zmm1.b[i] keeps its value
# zmm1 is zeroed from bit VL upRun on AMD Zen 5 (EPYC 9645): 10 cases.
Operands
| Operand | Kind | Action |
|---|---|---|
VPSUBB xmm, xmm, xmm/m128 VPSUBB ymm, ymm, ymm/m256 | ||
xmm, ymm | explicit | write |
xmm, ymm | explicit | read |
xmm/m128, ymm/m256 | explicit | read |
VPSUBB xmm {k}{z}, xmm, xmm/m128 VPSUBB ymm {k}{z}, ymm, ymm/m256 VPSUBB zmm {k}{z}, zmm, zmm/m512 | ||
xmm, ymm, zmm | explicit | write (masked) |
{k} | explicit | read (write mask) |
xmm, ymm, zmm | explicit | read |
xmm/m128, ymm/m256, zmm/m512 | 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.
- VEX forms
avx-type-4- EVEX forms
AVX512-E4
Attributes
What else XED records about the forms. How to read.
- EVEX forms
- write masking
- EVEX memory forms
- memory fault suppression
Intrinsics
The C intrinsics of Clang 23.1.2 that compile to VPSUBB, 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_mask_sub_epi8
__m128i _mm_mask_sub_epi8(__m128i __W, __mmask16 __U, __m128i __A, __m128i __B) |
|
_mm_maskz_sub_epi8
__m128i _mm_maskz_sub_epi8(__mmask16 __U, __m128i __A, __m128i __B) |
|
_mm256_sub_epi8
__m256i _mm256_sub_epi8(__m256i __a, __m256i __b) |
|
_mm256_mask_sub_epi8
__m256i _mm256_mask_sub_epi8(__m256i __W, __mmask32 __U, __m256i __A, __m256i __B) |
|
_mm256_maskz_sub_epi8
__m256i _mm256_maskz_sub_epi8(__mmask32 __U, __m256i __A, __m256i __B) |
|
_mm512_sub_epi8
__m512i _mm512_sub_epi8(__m512i __A, __m512i __B) |
|
_mm512_mask_sub_epi8
__m512i _mm512_mask_sub_epi8(__m512i __W, __mmask64 __U, __m512i __A, __m512i __B) |
|
_mm512_maskz_sub_epi8
__m512i _mm512_maskz_sub_epi8(__mmask64 __U, __m512i __A, __m512i __B) |
|
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 AVX instructions
- VPMULUDQ
- VPOR
- VPSADBW
- VPSHUFB
- VPSHUFD
- VPSHUFHW
- VPSHUFLW
- VPSIGNB
- VPSIGND
- VPSIGNW
- VPSLLD
- VPSLLDQ
- VPSLLQ
- VPSLLW
- VPSRAD
- VPSRAW
- VPSRLD
- VPSRLDQ
- VPSRLQ
- VPSRLW
- VPSUBD
- VPSUBQ
- VPSUBSB
- VPSUBSW
- VPSUBUSB
- VPSUBUSW
- VPSUBW
- VPTEST
- VPUNPCKHBW
- VPUNPCKHDQ
- VPUNPCKHQDQ
- VPUNPCKHWD
- VPUNPCKLBW
- VPUNPCKLDQ
- VPUNPCKLQDQ
- VPUNPCKLWD
- VPXOR
- VRCPPS
- VRCPSS
- VROUNDPD
More AVX2 instructions
- VPOR
- VPSADBW
- VPSHUFB
- VPSHUFD
- VPSHUFHW
- VPSHUFLW
- VPSIGNB
- VPSIGND
- VPSIGNW
- VPSLLD
- VPSLLDQ
- VPSLLQ
- VPSLLVD
- VPSLLVQ
- VPSLLW
- VPSRAD
- VPSRAVD
- VPSRAW
- VPSRLD
- VPSRLDQ
- VPSRLQ
- VPSRLVD
- VPSRLVQ
- VPSRLW
- VPSUBD
- VPSUBQ
- VPSUBSB
- VPSUBSW
- VPSUBUSB
- VPSUBUSW
- VPSUBW
- VPUNPCKHBW
- VPUNPCKHDQ
- VPUNPCKHQDQ
- VPUNPCKHWD
- VPUNPCKLBW
- VPUNPCKLDQ
- VPUNPCKLQDQ
- VPUNPCKLWD
- VPXOR
More AVX10.1 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. - LLVM 23.1.2's x86 scheduling models (commit
85ac56026243): the latency, reciprocal throughput and ports of each form, as llvm-mca reports 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 Advanced Vector Extensions 10.2 Architecture Specification, revision 7.0 (361050-007, April 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 and the timings from LLVM's scheduling models, both part of the LLVM Project, licensed under the Apache License 2.0 with LLVM Exceptions. The text is our own.