std.cpu.features — CPU-Feature-Erkennung

Erkennt zur Laufzeit, welche SIMD-Erweiterungen die aktuelle CPU unterstützt (SSE2, SSE4.1, AVX2). Das Ergebnis wird beim ersten Aufruf gecacht und dann ohne erneuten Syscall zurückgegeben.

→ Standard Library · std.cpu.dispatch · Lyx-Dokumentation

Implementierungsstand: Diese Unit ist Teil von WP-GPU-02 des internen SIMD/GPU-Fahrplans und befindet sich in aktiver Entwicklung. Konstanten und Funktionen tragen noch keine pub-Deklarationen; die Import-Pfade verwenden den Dev-Präfix src.std.*.

import std.cpu.features;

Die Feature-Flags sind Bits einer int64-Maske:

fn CpuFeatureDetect(): int64

Liest /proc/cpuinfo (max. 8 192 Byte), sucht nach den Token `` sse2``, `` sse4_1`` und `` avx2`` und gibt die kombinierte Feature-Maske zurück. Das Ergebnis wird in einem Modul-Global gecacht — /proc/cpuinfo wird nur beim ersten Aufruf gelesen.

fn CpuHasSSE2():  int64   // 1 wenn SSE2 verfügbar, sonst 0
fn CpuHasSSE41(): int64   // 1 wenn SSE4.1 verfügbar, sonst 0
fn CpuHasAVX2():  int64   // 1 wenn AVX2 verfügbar, sonst 0

Convenience-Wrapper über CpuFeatureDetect(). Jeder Aufruf prüft die gecachte Maske mit dem entsprechenden CPU_FEAT_*-Bit.

cpu_memmem ist modul-intern und nicht von außen aufrufbar.

• Einmaliger Syscall: Nach dem ersten CpuFeatureDetect()-Aufruf werden alle weiteren Aufrufe aus dem Cache bedient — kein erneutes Open / Read.
• Linux only: Die Erkennung basiert ausschließlich auf /proc/cpuinfo. Auf macOS, Windows oder Bare-Metal ist die Funktion nicht verwendbar (gibt 0 zurück oder schlägt beim Open fehl).
• Kein cpuid-Instruktionsaufruf: Die Implementierung verwendet keinen direkten x86-cpuid-Befehl, sondern den Kernel-seitigen /proc-Eintrag.
• Kein Reset: Der Cache kann nicht zurückgesetzt werden. Ein dynamischer CPU-Wechsel (Hotplug, Migration) wird nicht erkannt.

import std.cpu.features;
import std.io;

fn main() {
  var level: int64 := CpuFeatureDetect();

  if (CpuHasAVX2() != 0) {
    PrintLn("CPU: AVX2 verfügbar (256-Bit SIMD)");
  } else if (CpuHasSSE2() != 0) {
    PrintLn("CPU: SSE2 verfügbar (128-Bit SIMD)");
  } else {
    PrintLn("CPU: Kein SIMD — Scalar-Pfad aktiv");
  }

  // Direkte Bitmask-Auswertung
  if ((level & CPU_FEAT_SSE41) != 0) {
    PrintLn("SSE4.1 erkannt");
  }
}

Letzte Aktualisierung: 2026-06-13