archmage 0.9.17

Safely invoke your intrinsic power, using the tokens granted to you by the CPU. Cast primitive magics faster than any mage alive.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67

//! Generated from token-registry.toml — DO NOT EDIT.
//!
//! Marker traits for SIMD capability levels.

use crate::tokens::SimdToken;

/// Marker trait for tokens that provide 128-bit SIMD.
#[allow(deprecated)]
#[deprecated(
    since = "0.9.9",
    note = "Width traits are misleading (Has256BitSimd enables AVX, not AVX2). Use concrete tokens (X64V3Token) or tier traits (HasX64V2, HasX64V4) instead. Will be removed in v1.0."
)]
pub trait Has128BitSimd: SimdToken {}

/// Marker trait for tokens that provide 256-bit SIMD.
#[allow(deprecated)]
#[deprecated(
    since = "0.9.9",
    note = "Has256BitSimd only enables AVX, NOT AVX2 or FMA — causes suboptimal codegen. Use X64V3Token or HasX64V2 instead. Will be removed in v1.0."
)]
pub trait Has256BitSimd: Has128BitSimd {}

/// Marker trait for tokens that provide 512-bit SIMD.
#[allow(deprecated)]
#[deprecated(
    since = "0.9.9",
    note = "Width traits are misleading. Use X64V4Token or HasX64V4 instead. Will be removed in v1.0."
)]
pub trait Has512BitSimd: Has256BitSimd {}

/// Marker trait for x86-64-v2 level (Nehalem 2008+).
///
/// v2 includes: SSE3, SSSE3, SSE4.1, SSE4.2, POPCNT, CMPXCHG16B, LAHF-SAHF.
pub trait HasX64V2: SimdToken {}

/// Marker trait for x86-64-v4 level (Skylake-X 2017+, Zen 4 2022+).
///
/// v4 includes all of v3 plus: AVX512F, AVX512BW, AVX512CD, AVX512DQ, AVX512VL.
/// Implies HasX64V2.
pub trait HasX64V4: HasX64V2 {}

/// Marker trait for NEON on AArch64.
///
/// NEON is available on virtually all AArch64 processors.
pub trait HasNeon: SimdToken {}

/// Marker trait for NEON + AES.
///
/// AES extension is common on modern ARM64 devices (ARMv8-A with Crypto).
pub trait HasNeonAes: HasNeon {}

/// Marker trait for NEON + SHA3.
///
/// SHA3 extension is available on ARMv8.2-A and later.
pub trait HasNeonSha3: HasNeon {}

/// Marker trait for Arm64-v2 level.
///
/// Arm64-v2 includes: NEON, CRC, RDM, DotProd, FP16, AES, SHA2.
/// Available on Cortex-A55+, Apple M1+, Graviton 2+.
pub trait HasArm64V2: HasNeon + HasNeonAes {}

/// Marker trait for Arm64-v3 level.
///
/// Arm64-v3 adds FHM, FCMA, SHA3, I8MM, BF16 over Arm64-v2.
/// Available on Cortex-A510+, Apple M2+, Snapdragon X, Graviton 3+.
pub trait HasArm64V3: HasArm64V2 + HasNeonSha3 {}