fgf 3.0.0

Faster Galois Fields: SIMD and portable finite-field arithmetic (binary towers and prime fields) and vector kernels
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
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89

//! Implementation details for experimentation, with no compatibility guarantees.
//!
//! Paths, types, signatures, and behavior may change or disappear in any release.
//! Production consumers should use the supported API in [`crate::ops`],
//! [`crate::bits`], [`crate::field`], and [`crate::kernel`].

/// Direct kernel implementations, preparation tables, and capability tokens.
pub mod kernel {
    pub use crate::kernel::byte_ops::xor;
    #[cfg(all(feature = "simd", any(target_arch = "x86", target_arch = "x86_64")))]
    pub use crate::kernel::matrix_provider::{FlatMatrix, Matrix};

    /// Byte-field kernels and preparation.
    pub mod gf8 {
        pub use crate::kernel::gf8::*;
    }

    /// Quadratic tower kernels over GF(2¹⁶).
    pub mod gf16 {
        pub use crate::kernel::tower::gf16::*;
    }

    /// Quadratic tower kernels over GF(2³²).
    pub mod gf32 {
        pub use crate::kernel::tower::gf32::*;
    }

    /// Quadratic tower kernels over GF(2⁶⁴).
    pub mod gf64 {
        pub use crate::kernel::tower::gf64::*;
    }

    /// Rijndael-rooted quadratic tower kernel family.
    pub mod tower {
        pub use crate::kernel::tower::*;
    }

    /// Portable prime-field kernels.
    pub mod prime {
        pub use crate::kernel::prime::*;
    }

    /// Portable binary-field kernels and tails.
    pub mod scalar {
        pub use crate::kernel::scalar::*;
    }

    /// Coefficient tables shared by field and architecture kernels.
    pub mod tables {
        pub use crate::kernel::tables::*;
    }

    /// Token-bearing x86 kernels.
    #[cfg(all(feature = "simd", any(target_arch = "x86", target_arch = "x86_64")))]
    pub mod x86 {
        pub use crate::kernel::x86::*;
    }

    /// Token-bearing AArch64 kernels.
    #[cfg(all(feature = "simd", target_arch = "aarch64"))]
    pub mod aarch64 {
        pub use crate::kernel::aarch64::*;
    }

    /// Token-bearing WebAssembly kernels.
    #[cfg(all(feature = "simd", target_arch = "wasm32"))]
    pub mod wasm32 {
        pub use crate::kernel::wasm32::*;
    }

    #[cfg(feature = "simd")]
    pub use archmage::SimdToken;
    #[cfg(all(feature = "simd", target_arch = "wasm32", target_feature = "simd128"))]
    pub use archmage::Wasm128Token;
    #[cfg(all(feature = "simd", target_arch = "aarch64"))]
    pub use archmage::{NeonAesToken, NeonToken};
    #[cfg(all(feature = "simd", any(target_arch = "x86", target_arch = "x86_64")))]
    pub use archmage::{
        X64V1Token, X64V2Token, X64V3GfniCryptoToken, X64V3Token, X64V4Token, X64V4xToken,
    };
}

/// Independent scalar field oracles.
pub mod field {
    /// Fan–Paar recurrence for differential checks of the tower family.
    pub mod fan_paar {
        pub use crate::field::binary::tower::{fp_invert, fp_mul_alpha, fp_multiply, fp_square};
    }
}