portable-atomic 1.14.0

Portable atomic types including support for 128-bit atomics, atomic float, etc.
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

// SPDX-License-Identifier: Apache-2.0 OR MIT

/*
Run-time CPU feature detection on AArch64 Windows by using IsProcessorFeaturePresent.

Run-time detection of FEAT_LSE on Windows by is_aarch64_feature_detected is supported on Rust 1.70+.
https://github.com/rust-lang/stdarch/pull/1373

Refs: https://learn.microsoft.com/en-us/windows/win32/api/processthreadsapi/nf-processthreadsapi-isprocessorfeaturepresent
*/

include!("common.rs");

// windows-sys requires Rust 1.71
#[allow(non_camel_case_types, clippy::upper_case_acronyms)]
mod ffi {
    sys_type!({
        pub(crate) type [Win32::System::Threading] PROCESSOR_FEATURE_ID = u32;
        pub(crate) type [core] BOOL = i32;
    });

    sys_const!({
        pub(crate) const [Win32::Foundation] FALSE: BOOL = 0;

        // Defined in winnt.h of Windows SDK.
        pub(crate) const [Win32::System::Threading]
            PF_ARM_V81_ATOMIC_INSTRUCTIONS_AVAILABLE: PROCESSOR_FEATURE_ID = 34;
        #[cfg(test)]
        pub(crate) const [Win32::System::Threading]
            PF_ARM_V83_LRCPC_INSTRUCTIONS_AVAILABLE: PROCESSOR_FEATURE_ID = 45;
    });
    // TODO: put in sys_const! once windows-sys updated.
    pub(crate) const PF_ARM_LSE2_AVAILABLE: PROCESSOR_FEATURE_ID = 62;

    sys_fn!({
        extern "system" {
            // https://learn.microsoft.com/en-us/windows/win32/api/processthreadsapi/nf-processthreadsapi-isprocessorfeaturepresent
            pub(crate) fn [Win32::System::Threading] IsProcessorFeaturePresent(
                ProcessorFeature: PROCESSOR_FEATURE_ID,
            ) -> BOOL;
        }
    });
}

#[cold]
#[must_use]
fn _detect(mut info: CpuInfo) -> CpuInfo {
    macro_rules! check {
        ($flag:ident, $bit:ident) => {
            // SAFETY: calling IsProcessorFeaturePresent is safe, and FALSE is also
            // returned if the HAL does not support detection of the specified feature.
            if unsafe { ffi::IsProcessorFeaturePresent(ffi::$bit) != ffi::FALSE } {
                info.set(CpuInfoFlag::$flag);
            }
        };
    }
    check!(lse, PF_ARM_V81_ATOMIC_INSTRUCTIONS_AVAILABLE);
    check!(lse2, PF_ARM_LSE2_AVAILABLE);
    #[cfg(test)]
    check!(rcpc, PF_ARM_V83_LRCPC_INSTRUCTIONS_AVAILABLE);
    info
}