Skip to content

Commit 0f768d7

Browse files
committed
Optimized repositories: Added caution about Intel +12th gen AVX-512
support and why its now disabled.
1 parent 924191f commit 0f768d7

File tree

1 file changed

+12
-0
lines changed

1 file changed

+12
-0
lines changed

src/content/docs/features/optimized_repos.mdx

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -41,6 +41,18 @@ If you’re currently using the x86-64-v3 repositories and your new CPU supports
4141

4242
### Checking CPU Compatibility
4343

44+
:::caution
45+
Intel 12th gen (Alder Lake) and newer CPUs may report `x86-64-v4` support, but in practice they **cannot run AVX-512 instructions**.
46+
47+
Why?
48+
- **Hybrid architecture conflict**: The big “P-cores” support AVX-512, but the small “E-cores” do not. Running AVX-512 while E-cores are active would cause instability.
49+
- **Intel’s workaround**: To avoid this mismatch, Intel disabled AVX-512 in two ways:
50+
- **Microcode/BIOS updates** (early Alder Lake chips): AVX-512 could be re-enabled by avoiding or rolling back microcode updates.
51+
- **Hardware fusing** (later 2022+ chips): AVX-512 is permanently disabled at the factory, making it impossible to re-enable.
52+
53+
Because `x86-64-v4` requires AVX-512, these CPUs should be treated as **x86-64-v3 only**.
54+
:::
55+
4456
- Verifying `x86-64-v4` support:
4557
```sh title='Run the following command:'
4658
/lib/ld-linux-x86-64.so.2 --help | grep supported

0 commit comments

Comments
 (0)