aboutsummaryrefslogtreecommitdiff
path: root/vendor/portable-atomic/src/imp/atomic128/aarch64.rs
diff options
context:
space:
mode:
Diffstat (limited to 'vendor/portable-atomic/src/imp/atomic128/aarch64.rs')
-rw-r--r--vendor/portable-atomic/src/imp/atomic128/aarch64.rs1708
1 files changed, 0 insertions, 1708 deletions
diff --git a/vendor/portable-atomic/src/imp/atomic128/aarch64.rs b/vendor/portable-atomic/src/imp/atomic128/aarch64.rs
deleted file mode 100644
index 32528a7..0000000
--- a/vendor/portable-atomic/src/imp/atomic128/aarch64.rs
+++ /dev/null
@@ -1,1708 +0,0 @@
-// SPDX-License-Identifier: Apache-2.0 OR MIT
-
-// Atomic{I,U}128 implementation on AArch64.
-//
-// There are a few ways to implement 128-bit atomic operations in AArch64.
-//
-// - LDXP/STXP loop (DW LL/SC)
-// - CASP (DWCAS) added as FEAT_LSE (mandatory from armv8.1-a)
-// - LDP/STP (DW load/store) if FEAT_LSE2 (optional from armv8.2-a, mandatory from armv8.4-a) is available
-// - LDIAPP/STILP (DW acquire-load/release-store) added as FEAT_LRCPC3 (optional from armv8.9-a/armv9.4-a) (if FEAT_LSE2 is also available)
-// - LDCLRP/LDSETP/SWPP (DW RMW) added as FEAT_LSE128 (optional from armv9.4-a)
-//
-// If outline-atomics is not enabled and FEAT_LSE is not available at
-// compile-time, we use LDXP/STXP loop.
-// If outline-atomics is enabled and FEAT_LSE is not available at
-// compile-time, we use CASP for CAS if FEAT_LSE is available
-// at run-time, otherwise, use LDXP/STXP loop.
-// If FEAT_LSE is available at compile-time, we use CASP for load/store/CAS/RMW.
-// However, when portable_atomic_ll_sc_rmw cfg is set, use LDXP/STXP loop instead of CASP
-// loop for RMW (by default, it is set on Apple hardware; see build script for details).
-// If FEAT_LSE2 is available at compile-time, we use LDP/STP for load/store.
-// If FEAT_LSE128 is available at compile-time, we use LDCLRP/LDSETP/SWPP for fetch_and/fetch_or/swap/{release,seqcst}-store.
-// If FEAT_LSE2 and FEAT_LRCPC3 are available at compile-time, we use LDIAPP/STILP for acquire-load/release-store.
-//
-// Note: FEAT_LSE2 doesn't imply FEAT_LSE. FEAT_LSE128 implies FEAT_LSE but not FEAT_LSE2.
-//
-// Note that we do not separate LL and SC into separate functions, but handle
-// them within a single asm block. This is because it is theoretically possible
-// for the compiler to insert operations that might clear the reservation between
-// LL and SC. Considering the type of operations we are providing and the fact
-// that [progress64](https://github.com/ARM-software/progress64) uses such code,
-// this is probably not a problem for aarch64, but it seems that aarch64 doesn't
-// guarantee it and hexagon is the only architecture with hardware guarantees
-// that such code works. See also:
-//
-// - https://yarchive.net/comp/linux/cmpxchg_ll_sc_portability.html
-// - https://lists.llvm.org/pipermail/llvm-dev/2016-May/099490.html
-// - https://lists.llvm.org/pipermail/llvm-dev/2018-June/123993.html
-//
-// Also, even when using a CAS loop to implement atomic RMW, include the loop itself
-// in the asm block because it is more efficient for some codegen backends.
-// https://github.com/rust-lang/compiler-builtins/issues/339#issuecomment-1191260474
-//
-// Note: On Miri and ThreadSanitizer which do not support inline assembly, we don't use
-// this module and use intrinsics.rs instead.
-//
-// Refs:
-// - ARM Compiler armasm User Guide
-// https://developer.arm.com/documentation/dui0801/latest
-// - Arm A-profile A64 Instruction Set Architecture
-// https://developer.arm.com/documentation/ddi0602/latest
-// - Arm Architecture Reference Manual for A-profile architecture
-// https://developer.arm.com/documentation/ddi0487/latest
-// - atomic-maybe-uninit https://github.com/taiki-e/atomic-maybe-uninit
-//
-// Generated asm:
-// - aarch64 https://godbolt.org/z/5Mz1E33vz
-// - aarch64 msvc https://godbolt.org/z/P53d1MsGY
-// - aarch64 (+lse) https://godbolt.org/z/qvaE8n79K
-// - aarch64 msvc (+lse) https://godbolt.org/z/dj4aYerfr
-// - aarch64 (+lse,+lse2) https://godbolt.org/z/1E15jjxah
-// - aarch64 (+lse,+lse2,+rcpc3) https://godbolt.org/z/YreM4n84o
-// - aarch64 (+lse2,+lse128) https://godbolt.org/z/Kfeqs54ox
-// - aarch64 (+lse2,+lse128,+rcpc3) https://godbolt.org/z/n6zhjE77s
-
-include!("macros.rs");
-
-// On musl with static linking, it seems that getauxval is not always available.
-// See detect/auxv.rs for more.
-#[cfg(not(portable_atomic_no_outline_atomics))]
-#[cfg(any(
- test,
- not(all(
- any(target_feature = "lse2", portable_atomic_target_feature = "lse2"),
- any(target_feature = "lse", portable_atomic_target_feature = "lse"),
- )),
-))]
-#[cfg(any(
- all(
- target_os = "linux",
- any(
- target_env = "gnu",
- all(any(target_env = "musl", target_env = "ohos"), not(target_feature = "crt-static")),
- portable_atomic_outline_atomics,
- ),
- ),
- target_os = "android",
- target_os = "freebsd",
-))]
-#[path = "detect/auxv.rs"]
-mod detect;
-#[cfg(not(portable_atomic_no_outline_atomics))]
-#[cfg_attr(
- target_os = "netbsd",
- cfg(any(
- test,
- not(all(
- any(target_feature = "lse2", portable_atomic_target_feature = "lse2"),
- any(target_feature = "lse", portable_atomic_target_feature = "lse"),
- )),
- ))
-)]
-#[cfg_attr(
- target_os = "openbsd",
- cfg(any(test, not(any(target_feature = "lse", portable_atomic_target_feature = "lse"))))
-)]
-#[cfg(any(target_os = "netbsd", target_os = "openbsd"))]
-#[path = "detect/aarch64_aa64reg.rs"]
-mod detect;
-#[cfg(not(portable_atomic_no_outline_atomics))]
-#[cfg(any(test, not(any(target_feature = "lse", portable_atomic_target_feature = "lse"))))]
-#[cfg(target_os = "fuchsia")]
-#[path = "detect/aarch64_fuchsia.rs"]
-mod detect;
-#[cfg(not(portable_atomic_no_outline_atomics))]
-#[cfg(any(test, not(any(target_feature = "lse", portable_atomic_target_feature = "lse"))))]
-#[cfg(target_os = "windows")]
-#[path = "detect/aarch64_windows.rs"]
-mod detect;
-
-// test only
-#[cfg(test)]
-#[cfg(not(qemu))]
-#[cfg(not(valgrind))]
-#[cfg(not(portable_atomic_no_outline_atomics))]
-#[cfg(any(target_os = "linux", target_os = "android", target_os = "freebsd"))]
-#[path = "detect/aarch64_aa64reg.rs"]
-mod detect_aa64reg;
-#[cfg(test)]
-#[cfg(not(portable_atomic_no_outline_atomics))]
-#[cfg(target_os = "macos")]
-#[path = "detect/aarch64_macos.rs"]
-mod detect_macos;
-
-#[cfg(not(portable_atomic_no_asm))]
-use core::arch::asm;
-use core::sync::atomic::Ordering;
-
-use crate::utils::{Pair, U128};
-
-#[cfg(any(
- target_feature = "lse",
- portable_atomic_target_feature = "lse",
- not(portable_atomic_no_outline_atomics),
-))]
-macro_rules! debug_assert_lse {
- () => {
- #[cfg(all(
- not(portable_atomic_no_outline_atomics),
- any(
- all(
- target_os = "linux",
- any(
- target_env = "gnu",
- all(
- any(target_env = "musl", target_env = "ohos"),
- not(target_feature = "crt-static"),
- ),
- portable_atomic_outline_atomics,
- ),
- ),
- target_os = "android",
- target_os = "freebsd",
- target_os = "netbsd",
- target_os = "openbsd",
- target_os = "fuchsia",
- target_os = "windows",
- ),
- ))]
- #[cfg(not(any(target_feature = "lse", portable_atomic_target_feature = "lse")))]
- {
- debug_assert!(detect::detect().has_lse());
- }
- };
-}
-#[rustfmt::skip]
-#[cfg(any(
- target_feature = "lse2",
- portable_atomic_target_feature = "lse2",
- not(portable_atomic_no_outline_atomics),
-))]
-macro_rules! debug_assert_lse2 {
- () => {
- #[cfg(all(
- not(portable_atomic_no_outline_atomics),
- any(
- all(
- target_os = "linux",
- any(
- target_env = "gnu",
- all(
- any(target_env = "musl", target_env = "ohos"),
- not(target_feature = "crt-static"),
- ),
- portable_atomic_outline_atomics,
- ),
- ),
- target_os = "android",
- target_os = "freebsd",
- target_os = "netbsd",
- // These don't support detection of FEAT_LSE2.
- // target_os = "openbsd",
- // target_os = "fuchsia",
- // target_os = "windows",
- ),
- ))]
- #[cfg(not(any(target_feature = "lse2", portable_atomic_target_feature = "lse2")))]
- {
- debug_assert!(detect::detect().has_lse2());
- }
- };
-}
-
-// Refs: https://developer.arm.com/documentation/100067/0612/armclang-Integrated-Assembler/AArch32-Target-selection-directives?lang=en
-//
-// This is similar to #[target_feature(enable = "lse")], except that there are
-// no compiler guarantees regarding (un)inlining, and the scope is within an asm
-// block rather than a function. We use this directive to support outline-atomics
-// on pre-1.61 rustc (aarch64_target_feature stabilized in Rust 1.61).
-//
-// The .arch_extension directive is effective until the end of the assembly block and
-// is not propagated to subsequent code, so the end_lse macro is unneeded.
-// https://godbolt.org/z/4oMEW8vWc
-// https://github.com/torvalds/linux/commit/e0d5896bd356cd577f9710a02d7a474cdf58426b
-// https://github.com/torvalds/linux/commit/dd1f6308b28edf0452dd5dc7877992903ec61e69
-// (It seems GCC effectively ignores this directive and always allow FEAT_LSE instructions: https://godbolt.org/z/W9W6rensG)
-//
-// The .arch directive has a similar effect, but we don't use it due to the following issue:
-// https://github.com/torvalds/linux/commit/dd1f6308b28edf0452dd5dc7877992903ec61e69
-//
-// This is also needed for compatibility with rustc_codegen_cranelift:
-// https://github.com/rust-lang/rustc_codegen_cranelift/issues/1400#issuecomment-1774599775
-//
-// Note: If FEAT_LSE is not available at compile-time, we must guarantee that
-// the function that uses it is not inlined into a function where it is not
-// clear whether FEAT_LSE is available. Otherwise, (even if we checked whether
-// FEAT_LSE is available at run-time) optimizations that reorder its
-// instructions across the if condition might introduce undefined behavior.
-// (see also https://rust-lang.github.io/rfcs/2045-target-feature.html#safely-inlining-target_feature-functions-on-more-contexts)
-// However, our code uses the ifunc helper macro that works with function pointers,
-// so we don't have to worry about this unless calling without helper macro.
-#[cfg(any(
- target_feature = "lse",
- portable_atomic_target_feature = "lse",
- not(portable_atomic_no_outline_atomics),
-))]
-macro_rules! start_lse {
- () => {
- ".arch_extension lse"
- };
-}
-
-#[cfg(target_endian = "little")]
-macro_rules! select_le_or_be {
- ($le:expr, $be:expr) => {
- $le
- };
-}
-#[cfg(target_endian = "big")]
-macro_rules! select_le_or_be {
- ($le:expr, $be:expr) => {
- $be
- };
-}
-
-macro_rules! atomic_rmw {
- ($op:ident, $order:ident) => {
- atomic_rmw!($op, $order, write = $order)
- };
- ($op:ident, $order:ident, write = $write:ident) => {
- match $order {
- Ordering::Relaxed => $op!("", "", ""),
- Ordering::Acquire => $op!("a", "", ""),
- Ordering::Release => $op!("", "l", ""),
- Ordering::AcqRel => $op!("a", "l", ""),
- // In MSVC environments, SeqCst stores/writes needs fences after writes.
- // https://reviews.llvm.org/D141748
- #[cfg(target_env = "msvc")]
- Ordering::SeqCst if $write == Ordering::SeqCst => $op!("a", "l", "dmb ish"),
- // AcqRel and SeqCst RMWs are equivalent in non-MSVC environments.
- Ordering::SeqCst => $op!("a", "l", ""),
- _ => unreachable!("{:?}", $order),
- }
- };
-}
-
-// cfg guarantee that the CPU supports FEAT_LSE2.
-#[cfg(any(target_feature = "lse2", portable_atomic_target_feature = "lse2"))]
-use _atomic_load_ldp as atomic_load;
-#[cfg(not(any(target_feature = "lse2", portable_atomic_target_feature = "lse2")))]
-#[inline]
-unsafe fn atomic_load(src: *mut u128, order: Ordering) -> u128 {
- #[inline]
- unsafe fn atomic_load_no_lse2(src: *mut u128, order: Ordering) -> u128 {
- #[cfg(any(target_feature = "lse", portable_atomic_target_feature = "lse"))]
- // SAFETY: the caller must uphold the safety contract.
- // cfg guarantee that the CPU supports FEAT_LSE.
- unsafe {
- _atomic_load_casp(src, order)
- }
- #[cfg(not(any(target_feature = "lse", portable_atomic_target_feature = "lse")))]
- // SAFETY: the caller must uphold the safety contract.
- unsafe {
- _atomic_load_ldxp_stxp(src, order)
- }
- }
- #[cfg(not(all(
- not(portable_atomic_no_outline_atomics),
- any(
- all(
- target_os = "linux",
- any(
- target_env = "gnu",
- all(
- any(target_env = "musl", target_env = "ohos"),
- not(target_feature = "crt-static"),
- ),
- portable_atomic_outline_atomics,
- ),
- ),
- target_os = "android",
- target_os = "freebsd",
- target_os = "netbsd",
- // These don't support detection of FEAT_LSE2.
- // target_os = "openbsd",
- // target_os = "fuchsia",
- // target_os = "windows",
- ),
- )))]
- // SAFETY: the caller must uphold the safety contract.
- unsafe {
- atomic_load_no_lse2(src, order)
- }
- #[cfg(all(
- not(portable_atomic_no_outline_atomics),
- any(
- all(
- target_os = "linux",
- any(
- target_env = "gnu",
- all(
- any(target_env = "musl", target_env = "ohos"),
- not(target_feature = "crt-static"),
- ),
- portable_atomic_outline_atomics,
- ),
- ),
- target_os = "android",
- target_os = "freebsd",
- target_os = "netbsd",
- // These don't support detection of FEAT_LSE2.
- // target_os = "openbsd",
- // target_os = "fuchsia",
- // target_os = "windows",
- ),
- ))]
- {
- fn_alias! {
- // inline(never) is just a hint and also not strictly necessary
- // because we use ifunc helper macro, but used for clarity.
- #[inline(never)]
- unsafe fn(src: *mut u128) -> u128;
- atomic_load_lse2_relaxed = _atomic_load_ldp(Ordering::Relaxed);
- atomic_load_lse2_acquire = _atomic_load_ldp(Ordering::Acquire);
- atomic_load_lse2_seqcst = _atomic_load_ldp(Ordering::SeqCst);
- }
- fn_alias! {
- unsafe fn(src: *mut u128) -> u128;
- atomic_load_no_lse2_relaxed = atomic_load_no_lse2(Ordering::Relaxed);
- atomic_load_no_lse2_acquire = atomic_load_no_lse2(Ordering::Acquire);
- atomic_load_no_lse2_seqcst = atomic_load_no_lse2(Ordering::SeqCst);
- }
- // SAFETY: the caller must uphold the safety contract.
- // and we've checked if FEAT_LSE2 is available.
- unsafe {
- match order {
- Ordering::Relaxed => {
- ifunc!(unsafe fn(src: *mut u128) -> u128 {
- let cpuinfo = detect::detect();
- if cpuinfo.has_lse2() {
- atomic_load_lse2_relaxed
- } else {
- atomic_load_no_lse2_relaxed
- }
- })
- }
- Ordering::Acquire => {
- ifunc!(unsafe fn(src: *mut u128) -> u128 {
- let cpuinfo = detect::detect();
- if cpuinfo.has_lse2() {
- atomic_load_lse2_acquire
- } else {
- atomic_load_no_lse2_acquire
- }
- })
- }
- Ordering::SeqCst => {
- ifunc!(unsafe fn(src: *mut u128) -> u128 {
- let cpuinfo = detect::detect();
- if cpuinfo.has_lse2() {
- atomic_load_lse2_seqcst
- } else {
- atomic_load_no_lse2_seqcst
- }
- })
- }
- _ => unreachable!("{:?}", order),
- }
- }
- }
-}
-// If CPU supports FEAT_LSE2, LDP/LDIAPP is single-copy atomic reads,
-// otherwise it is two single-copy atomic reads.
-// Refs: B2.2.1 of the Arm Architecture Reference Manual Armv8, for Armv8-A architecture profile
-#[cfg(any(
- target_feature = "lse2",
- portable_atomic_target_feature = "lse2",
- not(portable_atomic_no_outline_atomics),
-))]
-#[inline]
-unsafe fn _atomic_load_ldp(src: *mut u128, order: Ordering) -> u128 {
- debug_assert!(src as usize % 16 == 0);
- debug_assert_lse2!();
-
- // SAFETY: the caller must guarantee that `dst` is valid for reads,
- // 16-byte aligned, that there are no concurrent non-atomic operations.
- //
- // Refs:
- // - LDP: https://developer.arm.com/documentation/dui0801/l/A64-Data-Transfer-Instructions/LDP--A64-
- unsafe {
- let (out_lo, out_hi);
- macro_rules! atomic_load_relaxed {
- ($acquire:tt $(, $readonly:tt)?) => {
- asm!(
- "ldp {out_lo}, {out_hi}, [{src}]",
- $acquire,
- src = in(reg) ptr_reg!(src),
- out_hi = lateout(reg) out_hi,
- out_lo = lateout(reg) out_lo,
- options(nostack, preserves_flags $(, $readonly)?),
- )
- };
- }
- match order {
- Ordering::Relaxed => atomic_load_relaxed!("", readonly),
- #[cfg(any(target_feature = "rcpc3", portable_atomic_target_feature = "rcpc3"))]
- Ordering::Acquire => {
- // SAFETY: cfg guarantee that the CPU supports FEAT_LRCPC3.
- // Refs: https://developer.arm.com/documentation/ddi0602/2023-03/Base-Instructions/LDIAPP--Load-Acquire-RCpc-ordered-Pair-of-registers-
- asm!(
- "ldiapp {out_lo}, {out_hi}, [{src}]",
- src = in(reg) ptr_reg!(src),
- out_hi = lateout(reg) out_hi,
- out_lo = lateout(reg) out_lo,
- options(nostack, preserves_flags),
- );
- }
- #[cfg(not(any(target_feature = "rcpc3", portable_atomic_target_feature = "rcpc3")))]
- Ordering::Acquire => atomic_load_relaxed!("dmb ishld"),
- Ordering::SeqCst => {
- asm!(
- // ldar (or dmb ishld) is required to prevent reordering with preceding stlxp.
- // See https://gcc.gnu.org/bugzilla/show_bug.cgi?id=108891 for details.
- "ldar {tmp}, [{src}]",
- "ldp {out_lo}, {out_hi}, [{src}]",
- "dmb ishld",
- src = in(reg) ptr_reg!(src),
- out_hi = lateout(reg) out_hi,
- out_lo = lateout(reg) out_lo,
- tmp = out(reg) _,
- options(nostack, preserves_flags),
- );
- }
- _ => unreachable!("{:?}", order),
- }
- U128 { pair: Pair { lo: out_lo, hi: out_hi } }.whole
- }
-}
-// Do not use _atomic_compare_exchange_casp because it needs extra MOV to implement load.
-#[cfg(any(test, not(any(target_feature = "lse2", portable_atomic_target_feature = "lse2"))))]
-#[cfg(any(target_feature = "lse", portable_atomic_target_feature = "lse"))]
-#[inline]
-unsafe fn _atomic_load_casp(src: *mut u128, order: Ordering) -> u128 {
- debug_assert!(src as usize % 16 == 0);
- debug_assert_lse!();
-
- // SAFETY: the caller must uphold the safety contract.
- // cfg guarantee that the CPU supports FEAT_LSE.
- unsafe {
- let (out_lo, out_hi);
- macro_rules! atomic_load {
- ($acquire:tt, $release:tt) => {
- asm!(
- start_lse!(),
- concat!("casp", $acquire, $release, " x2, x3, x2, x3, [{src}]"),
- src = in(reg) ptr_reg!(src),
- // must be allocated to even/odd register pair
- inout("x2") 0_u64 => out_lo,
- inout("x3") 0_u64 => out_hi,
- options(nostack, preserves_flags),
- )
- };
- }
- match order {
- Ordering::Relaxed => atomic_load!("", ""),
- Ordering::Acquire => atomic_load!("a", ""),
- Ordering::SeqCst => atomic_load!("a", "l"),
- _ => unreachable!("{:?}", order),
- }
- U128 { pair: Pair { lo: out_lo, hi: out_hi } }.whole
- }
-}
-#[cfg(any(
- test,
- all(
- not(any(target_feature = "lse2", portable_atomic_target_feature = "lse2")),
- not(any(target_feature = "lse", portable_atomic_target_feature = "lse")),
- ),
-))]
-#[inline]
-unsafe fn _atomic_load_ldxp_stxp(src: *mut u128, order: Ordering) -> u128 {
- debug_assert!(src as usize % 16 == 0);
-
- // SAFETY: the caller must uphold the safety contract.
- unsafe {
- let (mut out_lo, mut out_hi);
- macro_rules! atomic_load {
- ($acquire:tt, $release:tt) => {
- asm!(
- "2:",
- concat!("ld", $acquire, "xp {out_lo}, {out_hi}, [{src}]"),
- concat!("st", $release, "xp {r:w}, {out_lo}, {out_hi}, [{src}]"),
- // 0 if the store was successful, 1 if no store was performed
- "cbnz {r:w}, 2b",
- src = in(reg) ptr_reg!(src),
- out_lo = out(reg) out_lo,
- out_hi = out(reg) out_hi,
- r = out(reg) _,
- options(nostack, preserves_flags),
- )
- };
- }
- match order {
- Ordering::Relaxed => atomic_load!("", ""),
- Ordering::Acquire => atomic_load!("a", ""),
- Ordering::SeqCst => atomic_load!("a", "l"),
- _ => unreachable!("{:?}", order),
- }
- U128 { pair: Pair { lo: out_lo, hi: out_hi } }.whole
- }
-}
-
-// cfg guarantee that the CPU supports FEAT_LSE2.
-#[cfg(any(target_feature = "lse2", portable_atomic_target_feature = "lse2"))]
-use _atomic_store_stp as atomic_store;
-#[cfg(not(any(target_feature = "lse2", portable_atomic_target_feature = "lse2")))]
-#[inline]
-unsafe fn atomic_store(dst: *mut u128, val: u128, order: Ordering) {
- #[inline]
- unsafe fn atomic_store_no_lse2(dst: *mut u128, val: u128, order: Ordering) {
- // If FEAT_LSE is available at compile-time and portable_atomic_ll_sc_rmw cfg is not set,
- // we use CAS-based atomic RMW.
- #[cfg(all(
- any(target_feature = "lse", portable_atomic_target_feature = "lse"),
- not(portable_atomic_ll_sc_rmw),
- ))]
- // SAFETY: the caller must uphold the safety contract.
- // cfg guarantee that the CPU supports FEAT_LSE.
- unsafe {
- _atomic_swap_casp(dst, val, order);
- }
- #[cfg(not(all(
- any(target_feature = "lse", portable_atomic_target_feature = "lse"),
- not(portable_atomic_ll_sc_rmw),
- )))]
- // SAFETY: the caller must uphold the safety contract.
- unsafe {
- _atomic_store_ldxp_stxp(dst, val, order);
- }
- }
- #[cfg(not(all(
- not(portable_atomic_no_outline_atomics),
- any(
- all(
- target_os = "linux",
- any(
- target_env = "gnu",
- all(
- any(target_env = "musl", target_env = "ohos"),
- not(target_feature = "crt-static"),
- ),
- portable_atomic_outline_atomics,
- ),
- ),
- target_os = "android",
- target_os = "freebsd",
- target_os = "netbsd",
- // These don't support detection of FEAT_LSE2.
- // target_os = "openbsd",
- // target_os = "fuchsia",
- // target_os = "windows",
- ),
- )))]
- // SAFETY: the caller must uphold the safety contract.
- unsafe {
- atomic_store_no_lse2(dst, val, order);
- }
- #[cfg(all(
- not(portable_atomic_no_outline_atomics),
- any(
- all(
- target_os = "linux",
- any(
- target_env = "gnu",
- all(
- any(target_env = "musl", target_env = "ohos"),
- not(target_feature = "crt-static"),
- ),
- portable_atomic_outline_atomics,
- ),
- ),
- target_os = "android",
- target_os = "freebsd",
- target_os = "netbsd",
- // These don't support detection of FEAT_LSE2.
- // target_os = "openbsd",
- // target_os = "fuchsia",
- // target_os = "windows",
- ),
- ))]
- {
- fn_alias! {
- // inline(never) is just a hint and also not strictly necessary
- // because we use ifunc helper macro, but used for clarity.
- #[inline(never)]
- unsafe fn(dst: *mut u128, val: u128);
- atomic_store_lse2_relaxed = _atomic_store_stp(Ordering::Relaxed);
- atomic_store_lse2_release = _atomic_store_stp(Ordering::Release);
- atomic_store_lse2_seqcst = _atomic_store_stp(Ordering::SeqCst);
- }
- fn_alias! {
- unsafe fn(dst: *mut u128, val: u128);
- atomic_store_no_lse2_relaxed = atomic_store_no_lse2(Ordering::Relaxed);
- atomic_store_no_lse2_release = atomic_store_no_lse2(Ordering::Release);
- atomic_store_no_lse2_seqcst = atomic_store_no_lse2(Ordering::SeqCst);
- }
- // SAFETY: the caller must uphold the safety contract.
- // and we've checked if FEAT_LSE2 is available.
- unsafe {
- match order {
- Ordering::Relaxed => {
- ifunc!(unsafe fn(dst: *mut u128, val: u128) {
- let cpuinfo = detect::detect();
- if cpuinfo.has_lse2() {
- atomic_store_lse2_relaxed
- } else {
- atomic_store_no_lse2_relaxed
- }
- });
- }
- Ordering::Release => {
- ifunc!(unsafe fn(dst: *mut u128, val: u128) {
- let cpuinfo = detect::detect();
- if cpuinfo.has_lse2() {
- atomic_store_lse2_release
- } else {
- atomic_store_no_lse2_release
- }
- });
- }
- Ordering::SeqCst => {
- ifunc!(unsafe fn(dst: *mut u128, val: u128) {
- let cpuinfo = detect::detect();
- if cpuinfo.has_lse2() {
- atomic_store_lse2_seqcst
- } else {
- atomic_store_no_lse2_seqcst
- }
- });
- }
- _ => unreachable!("{:?}", order),
- }
- }
- }
-}
-// If CPU supports FEAT_LSE2, STP/STILP is single-copy atomic writes,
-// otherwise it is two single-copy atomic writes.
-// Refs: B2.2.1 of the Arm Architecture Reference Manual Armv8, for Armv8-A architecture profile
-#[cfg(any(
- target_feature = "lse2",
- portable_atomic_target_feature = "lse2",
- not(portable_atomic_no_outline_atomics),
-))]
-#[inline]
-unsafe fn _atomic_store_stp(dst: *mut u128, val: u128, order: Ordering) {
- debug_assert!(dst as usize % 16 == 0);
- debug_assert_lse2!();
-
- // SAFETY: the caller must guarantee that `dst` is valid for writes,
- // 16-byte aligned, that there are no concurrent non-atomic operations.
- //
- // Refs:
- // - STP: https://developer.arm.com/documentation/dui0801/l/A64-Data-Transfer-Instructions/STP--A64-
- unsafe {
- #[rustfmt::skip]
- macro_rules! atomic_store {
- ($acquire:tt, $release:tt) => {{
- let val = U128 { whole: val };
- asm!(
- $release,
- "stp {val_lo}, {val_hi}, [{dst}]",
- $acquire,
- dst = in(reg) ptr_reg!(dst),
- val_lo = in(reg) val.pair.lo,
- val_hi = in(reg) val.pair.hi,
- options(nostack, preserves_flags),
- );
- }};
- }
- match order {
- Ordering::Relaxed => atomic_store!("", ""),
- #[cfg(any(target_feature = "rcpc3", portable_atomic_target_feature = "rcpc3"))]
- Ordering::Release => {
- let val = U128 { whole: val };
- // SAFETY: cfg guarantee that the CPU supports FEAT_LRCPC3.
- // Refs: https://developer.arm.com/documentation/ddi0602/2023-03/Base-Instructions/STILP--Store-Release-ordered-Pair-of-registers-
- asm!(
- "stilp {val_lo}, {val_hi}, [{dst}]",
- dst = in(reg) ptr_reg!(dst),
- val_lo = in(reg) val.pair.lo,
- val_hi = in(reg) val.pair.hi,
- options(nostack, preserves_flags),
- );
- }
- #[cfg(not(any(target_feature = "rcpc3", portable_atomic_target_feature = "rcpc3")))]
- #[cfg(any(target_feature = "lse128", portable_atomic_target_feature = "lse128"))]
- Ordering::Release => {
- // Use swpp if stp requires fences.
- // https://reviews.llvm.org/D143506
- // SAFETY: cfg guarantee that the CPU supports FEAT_LSE128.
- _atomic_swap_swpp(dst, val, order);
- }
- #[cfg(not(any(target_feature = "rcpc3", portable_atomic_target_feature = "rcpc3")))]
- #[cfg(not(any(target_feature = "lse128", portable_atomic_target_feature = "lse128")))]
- Ordering::Release => atomic_store!("", "dmb ish"),
- #[cfg(any(target_feature = "lse128", portable_atomic_target_feature = "lse128"))]
- Ordering::SeqCst => {
- // Use swpp if stp requires fences.
- // https://reviews.llvm.org/D143506
- // SAFETY: cfg guarantee that the CPU supports FEAT_LSE128.
- _atomic_swap_swpp(dst, val, order);
- }
- #[cfg(not(any(target_feature = "lse128", portable_atomic_target_feature = "lse128")))]
- Ordering::SeqCst => atomic_store!("dmb ish", "dmb ish"),
- _ => unreachable!("{:?}", order),
- }
- }
-}
-// Do not use _atomic_swap_ldxp_stxp because it needs extra registers to implement store.
-#[cfg(any(
- test,
- not(all(
- any(target_feature = "lse", portable_atomic_target_feature = "lse"),
- not(portable_atomic_ll_sc_rmw),
- ))
-))]
-#[inline]
-unsafe fn _atomic_store_ldxp_stxp(dst: *mut u128, val: u128, order: Ordering) {
- debug_assert!(dst as usize % 16 == 0);
-
- // SAFETY: the caller must uphold the safety contract.
- unsafe {
- let val = U128 { whole: val };
- macro_rules! store {
- ($acquire:tt, $release:tt, $fence:tt) => {
- asm!(
- "2:",
- concat!("ld", $acquire, "xp xzr, {tmp}, [{dst}]"),
- concat!("st", $release, "xp {tmp:w}, {val_lo}, {val_hi}, [{dst}]"),
- // 0 if the store was successful, 1 if no store was performed
- "cbnz {tmp:w}, 2b",
- $fence,
- dst = in(reg) ptr_reg!(dst),
- val_lo = in(reg) val.pair.lo,
- val_hi = in(reg) val.pair.hi,
- tmp = out(reg) _,
- options(nostack, preserves_flags),
- )
- };
- }
- atomic_rmw!(store, order);
- }
-}
-
-#[inline]
-unsafe fn atomic_compare_exchange(
- dst: *mut u128,
- old: u128,
- new: u128,
- success: Ordering,
- failure: Ordering,
-) -> Result<u128, u128> {
- #[cfg(any(target_feature = "lse", portable_atomic_target_feature = "lse"))]
- // SAFETY: the caller must uphold the safety contract.
- // cfg guarantee that the CPU supports FEAT_LSE.
- let prev = unsafe { _atomic_compare_exchange_casp(dst, old, new, success, failure) };
- #[cfg(not(all(
- not(portable_atomic_no_outline_atomics),
- any(
- all(
- target_os = "linux",
- any(
- target_env = "gnu",
- all(
- any(target_env = "musl", target_env = "ohos"),
- not(target_feature = "crt-static"),
- ),
- portable_atomic_outline_atomics,
- ),
- ),
- target_os = "android",
- target_os = "freebsd",
- target_os = "netbsd",
- target_os = "openbsd",
- target_os = "fuchsia",
- target_os = "windows",
- ),
- )))]
- #[cfg(not(any(target_feature = "lse", portable_atomic_target_feature = "lse")))]
- // SAFETY: the caller must uphold the safety contract.
- let prev = unsafe { _atomic_compare_exchange_ldxp_stxp(dst, old, new, success, failure) };
- #[cfg(all(
- not(portable_atomic_no_outline_atomics),
- any(
- all(
- target_os = "linux",
- any(
- target_env = "gnu",
- all(
- any(target_env = "musl", target_env = "ohos"),
- not(target_feature = "crt-static"),
- ),
- portable_atomic_outline_atomics,
- ),
- ),
- target_os = "android",
- target_os = "freebsd",
- target_os = "netbsd",
- target_os = "openbsd",
- target_os = "fuchsia",
- target_os = "windows",
- ),
- ))]
- #[cfg(not(any(target_feature = "lse", portable_atomic_target_feature = "lse")))]
- let prev = {
- fn_alias! {
- // inline(never) is just a hint and also not strictly necessary
- // because we use ifunc helper macro, but used for clarity.
- #[inline(never)]
- unsafe fn(dst: *mut u128, old: u128, new: u128) -> u128;
- atomic_compare_exchange_casp_relaxed
- = _atomic_compare_exchange_casp(Ordering::Relaxed, Ordering::Relaxed);
- atomic_compare_exchange_casp_acquire
- = _atomic_compare_exchange_casp(Ordering::Acquire, Ordering::Acquire);
- atomic_compare_exchange_casp_release
- = _atomic_compare_exchange_casp(Ordering::Release, Ordering::Relaxed);
- atomic_compare_exchange_casp_acqrel
- = _atomic_compare_exchange_casp(Ordering::AcqRel, Ordering::Acquire);
- // AcqRel and SeqCst RMWs are equivalent in non-MSVC environments.
- #[cfg(target_env = "msvc")]
- atomic_compare_exchange_casp_seqcst
- = _atomic_compare_exchange_casp(Ordering::SeqCst, Ordering::SeqCst);
- }
- fn_alias! {
- unsafe fn(dst: *mut u128, old: u128, new: u128) -> u128;
- atomic_compare_exchange_ldxp_stxp_relaxed
- = _atomic_compare_exchange_ldxp_stxp(Ordering::Relaxed, Ordering::Relaxed);
- atomic_compare_exchange_ldxp_stxp_acquire
- = _atomic_compare_exchange_ldxp_stxp(Ordering::Acquire, Ordering::Acquire);
- atomic_compare_exchange_ldxp_stxp_release
- = _atomic_compare_exchange_ldxp_stxp(Ordering::Release, Ordering::Relaxed);
- atomic_compare_exchange_ldxp_stxp_acqrel
- = _atomic_compare_exchange_ldxp_stxp(Ordering::AcqRel, Ordering::Acquire);
- // AcqRel and SeqCst RMWs are equivalent in non-MSVC environments.
- #[cfg(target_env = "msvc")]
- atomic_compare_exchange_ldxp_stxp_seqcst
- = _atomic_compare_exchange_ldxp_stxp(Ordering::SeqCst, Ordering::SeqCst);
- }
- // SAFETY: the caller must guarantee that `dst` is valid for both writes and
- // reads, 16-byte aligned, that there are no concurrent non-atomic operations,
- // and we've checked if FEAT_LSE is available.
- unsafe {
- let success = crate::utils::upgrade_success_ordering(success, failure);
- match success {
- Ordering::Relaxed => {
- ifunc!(unsafe fn(dst: *mut u128, old: u128, new: u128) -> u128 {
- if detect::detect().has_lse() {
- atomic_compare_exchange_casp_relaxed
- } else {
- atomic_compare_exchange_ldxp_stxp_relaxed
- }
- })
- }
- Ordering::Acquire => {
- ifunc!(unsafe fn(dst: *mut u128, old: u128, new: u128) -> u128 {
- if detect::detect().has_lse() {
- atomic_compare_exchange_casp_acquire
- } else {
- atomic_compare_exchange_ldxp_stxp_acquire
- }
- })
- }
- Ordering::Release => {
- ifunc!(unsafe fn(dst: *mut u128, old: u128, new: u128) -> u128 {
- if detect::detect().has_lse() {
- atomic_compare_exchange_casp_release
- } else {
- atomic_compare_exchange_ldxp_stxp_release
- }
- })
- }
- // AcqRel and SeqCst RMWs are equivalent in both implementations in non-MSVC environments.
- #[cfg(not(target_env = "msvc"))]
- Ordering::AcqRel | Ordering::SeqCst => {
- ifunc!(unsafe fn(dst: *mut u128, old: u128, new: u128) -> u128 {
- if detect::detect().has_lse() {
- atomic_compare_exchange_casp_acqrel
- } else {
- atomic_compare_exchange_ldxp_stxp_acqrel
- }
- })
- }
- #[cfg(target_env = "msvc")]
- Ordering::AcqRel => {
- ifunc!(unsafe fn(dst: *mut u128, old: u128, new: u128) -> u128 {
- if detect::detect().has_lse() {
- atomic_compare_exchange_casp_acqrel
- } else {
- atomic_compare_exchange_ldxp_stxp_acqrel
- }
- })
- }
- #[cfg(target_env = "msvc")]
- Ordering::SeqCst => {
- ifunc!(unsafe fn(dst: *mut u128, old: u128, new: u128) -> u128 {
- if detect::detect().has_lse() {
- atomic_compare_exchange_casp_seqcst
- } else {
- atomic_compare_exchange_ldxp_stxp_seqcst
- }
- })
- }
- _ => unreachable!("{:?}", success),
- }
- }
- };
- if prev == old {
- Ok(prev)
- } else {
- Err(prev)
- }
-}
-#[cfg(any(
- target_feature = "lse",
- portable_atomic_target_feature = "lse",
- not(portable_atomic_no_outline_atomics),
-))]
-#[inline]
-unsafe fn _atomic_compare_exchange_casp(
- dst: *mut u128,
- old: u128,
- new: u128,
- success: Ordering,
- failure: Ordering,
-) -> u128 {
- debug_assert!(dst as usize % 16 == 0);
- debug_assert_lse!();
- let order = crate::utils::upgrade_success_ordering(success, failure);
-
- // SAFETY: the caller must guarantee that `dst` is valid for both writes and
- // reads, 16-byte aligned, that there are no concurrent non-atomic operations,
- // and the CPU supports FEAT_LSE.
- //
- // Refs:
- // - https://developer.arm.com/documentation/dui0801/l/A64-Data-Transfer-Instructions/CASPA--CASPAL--CASP--CASPL--CASPAL--CASP--CASPL--A64-
- // - https://developer.arm.com/documentation/ddi0602/2023-06/Base-Instructions/CASP--CASPA--CASPAL--CASPL--Compare-and-Swap-Pair-of-words-or-doublewords-in-memory-
- unsafe {
- let old = U128 { whole: old };
- let new = U128 { whole: new };
- let (prev_lo, prev_hi);
- macro_rules! cmpxchg {
- ($acquire:tt, $release:tt, $fence:tt) => {
- asm!(
- start_lse!(),
- concat!("casp", $acquire, $release, " x6, x7, x4, x5, [{dst}]"),
- $fence,
- dst = in(reg) ptr_reg!(dst),
- // must be allocated to even/odd register pair
- inout("x6") old.pair.lo => prev_lo,
- inout("x7") old.pair.hi => prev_hi,
- // must be allocated to even/odd register pair
- in("x4") new.pair.lo,
- in("x5") new.pair.hi,
- options(nostack, preserves_flags),
- )
- };
- }
- atomic_rmw!(cmpxchg, order, write = success);
- U128 { pair: Pair { lo: prev_lo, hi: prev_hi } }.whole
- }
-}
-#[cfg(any(test, not(any(target_feature = "lse", portable_atomic_target_feature = "lse"))))]
-#[inline]
-unsafe fn _atomic_compare_exchange_ldxp_stxp(
- dst: *mut u128,
- old: u128,
- new: u128,
- success: Ordering,
- failure: Ordering,
-) -> u128 {
- debug_assert!(dst as usize % 16 == 0);
- let order = crate::utils::upgrade_success_ordering(success, failure);
-
- // SAFETY: the caller must guarantee that `dst` is valid for both writes and
- // reads, 16-byte aligned, and that there are no concurrent non-atomic operations.
- //
- // Refs:
- // - LDXP: https://developer.arm.com/documentation/dui0801/l/A64-Data-Transfer-Instructions/LDXP--A64-
- // - LDAXP: https://developer.arm.com/documentation/dui0801/l/A64-Data-Transfer-Instructions/LDAXP--A64-
- // - STXP: https://developer.arm.com/documentation/dui0801/l/A64-Data-Transfer-Instructions/STXP--A64-
- // - STLXP: https://developer.arm.com/documentation/dui0801/l/A64-Data-Transfer-Instructions/STLXP--A64-
- //
- // Note: Load-Exclusive pair (by itself) does not guarantee atomicity; to complete an atomic
- // operation (even load/store), a corresponding Store-Exclusive pair must succeed.
- // See Arm Architecture Reference Manual for A-profile architecture
- // Section B2.2.1 "Requirements for single-copy atomicity", and
- // Section B2.9 "Synchronization and semaphores" for more.
- unsafe {
- let old = U128 { whole: old };
- let new = U128 { whole: new };
- let (mut prev_lo, mut prev_hi);
- macro_rules! cmpxchg {
- ($acquire:tt, $release:tt, $fence:tt) => {
- asm!(
- "2:",
- concat!("ld", $acquire, "xp {prev_lo}, {prev_hi}, [{dst}]"),
- "cmp {prev_lo}, {old_lo}",
- "cset {r:w}, ne",
- "cmp {prev_hi}, {old_hi}",
- "cinc {r:w}, {r:w}, ne",
- "cbz {r:w}, 3f",
- concat!("st", $release, "xp {r:w}, {prev_lo}, {prev_hi}, [{dst}]"),
- // 0 if the store was successful, 1 if no store was performed
- "cbnz {r:w}, 2b",
- "b 4f",
- "3:",
- concat!("st", $release, "xp {r:w}, {new_lo}, {new_hi}, [{dst}]"),
- // 0 if the store was successful, 1 if no store was performed
- "cbnz {r:w}, 2b",
- "4:",
- $fence,
- dst = in(reg) ptr_reg!(dst),
- old_lo = in(reg) old.pair.lo,
- old_hi = in(reg) old.pair.hi,
- new_lo = in(reg) new.pair.lo,
- new_hi = in(reg) new.pair.hi,
- prev_lo = out(reg) prev_lo,
- prev_hi = out(reg) prev_hi,
- r = out(reg) _,
- // Do not use `preserves_flags` because CMP modifies the condition flags.
- options(nostack),
- )
- };
- }
- atomic_rmw!(cmpxchg, order, write = success);
- U128 { pair: Pair { lo: prev_lo, hi: prev_hi } }.whole
- }
-}
-
-// casp is always strong, and ldxp requires a corresponding (succeed) stxp for
-// its atomicity (see code comment in _atomic_compare_exchange_ldxp_stxp).
-// (i.e., aarch64 doesn't have 128-bit weak CAS)
-use self::atomic_compare_exchange as atomic_compare_exchange_weak;
-
-// If FEAT_LSE is available at compile-time and portable_atomic_ll_sc_rmw cfg is not set,
-// we use CAS-based atomic RMW.
-#[cfg(not(any(target_feature = "lse128", portable_atomic_target_feature = "lse128")))]
-#[cfg(all(
- any(target_feature = "lse", portable_atomic_target_feature = "lse"),
- not(portable_atomic_ll_sc_rmw),
-))]
-use _atomic_swap_casp as atomic_swap;
-#[cfg(not(any(target_feature = "lse128", portable_atomic_target_feature = "lse128")))]
-#[cfg(not(all(
- any(target_feature = "lse", portable_atomic_target_feature = "lse"),
- not(portable_atomic_ll_sc_rmw),
-)))]
-use _atomic_swap_ldxp_stxp as atomic_swap;
-#[cfg(any(target_feature = "lse128", portable_atomic_target_feature = "lse128"))]
-use _atomic_swap_swpp as atomic_swap;
-#[cfg(any(target_feature = "lse128", portable_atomic_target_feature = "lse128"))]
-#[inline]
-unsafe fn _atomic_swap_swpp(dst: *mut u128, val: u128, order: Ordering) -> u128 {
- debug_assert!(dst as usize % 16 == 0);
-
- // SAFETY: the caller must guarantee that `dst` is valid for both writes and
- // reads, 16-byte aligned, that there are no concurrent non-atomic operations,
- // and the CPU supports FEAT_LSE128.
- //
- // Refs:
- // - https://developer.arm.com/documentation/ddi0602/2023-03/Base-Instructions/SWPP--SWPPA--SWPPAL--SWPPL--Swap-quadword-in-memory-?lang=en
- unsafe {
- let val = U128 { whole: val };
- let (prev_lo, prev_hi);
- macro_rules! swap {
- ($acquire:tt, $release:tt, $fence:tt) => {
- asm!(
- concat!("swpp", $acquire, $release, " {val_lo}, {val_hi}, [{dst}]"),
- $fence,
- dst = in(reg) ptr_reg!(dst),
- val_lo = inout(reg) val.pair.lo => prev_lo,
- val_hi = inout(reg) val.pair.hi => prev_hi,
- options(nostack, preserves_flags),
- )
- };
- }
- atomic_rmw!(swap, order);
- U128 { pair: Pair { lo: prev_lo, hi: prev_hi } }.whole
- }
-}
-// Do not use atomic_rmw_cas_3 because it needs extra MOV to implement swap.
-#[cfg(any(test, not(portable_atomic_ll_sc_rmw)))]
-#[cfg(any(target_feature = "lse", portable_atomic_target_feature = "lse"))]
-#[inline]
-unsafe fn _atomic_swap_casp(dst: *mut u128, val: u128, order: Ordering) -> u128 {
- debug_assert!(dst as usize % 16 == 0);
- debug_assert_lse!();
-
- // SAFETY: the caller must uphold the safety contract.
- // cfg guarantee that the CPU supports FEAT_LSE.
- unsafe {
- let val = U128 { whole: val };
- let (mut prev_lo, mut prev_hi);
- macro_rules! swap {
- ($acquire:tt, $release:tt, $fence:tt) => {
- asm!(
- start_lse!(),
- // If FEAT_LSE2 is not supported, this works like byte-wise atomic.
- // This is not single-copy atomic reads, but this is ok because subsequent
- // CAS will check for consistency.
- "ldp x4, x5, [{dst}]",
- "2:",
- // casp writes the current value to the first register pair,
- // so copy the `out`'s value for later comparison.
- "mov {tmp_lo}, x4",
- "mov {tmp_hi}, x5",
- concat!("casp", $acquire, $release, " x4, x5, x2, x3, [{dst}]"),
- "cmp {tmp_hi}, x5",
- "ccmp {tmp_lo}, x4, #0, eq",
- "b.ne 2b",
- $fence,
- dst = in(reg) ptr_reg!(dst),
- tmp_lo = out(reg) _,
- tmp_hi = out(reg) _,
- // must be allocated to even/odd register pair
- out("x4") prev_lo,
- out("x5") prev_hi,
- // must be allocated to even/odd register pair
- in("x2") val.pair.lo,
- in("x3") val.pair.hi,
- // Do not use `preserves_flags` because CMP and CCMP modify the condition flags.
- options(nostack),
- )
- };
- }
- atomic_rmw!(swap, order);
- U128 { pair: Pair { lo: prev_lo, hi: prev_hi } }.whole
- }
-}
-// Do not use atomic_rmw_ll_sc_3 because it needs extra MOV to implement swap.
-#[cfg(any(
- test,
- not(all(
- any(target_feature = "lse", portable_atomic_target_feature = "lse"),
- not(portable_atomic_ll_sc_rmw),
- ))
-))]
-#[inline]
-unsafe fn _atomic_swap_ldxp_stxp(dst: *mut u128, val: u128, order: Ordering) -> u128 {
- debug_assert!(dst as usize % 16 == 0);
-
- // SAFETY: the caller must uphold the safety contract.
- unsafe {
- let val = U128 { whole: val };
- let (mut prev_lo, mut prev_hi);
- macro_rules! swap {
- ($acquire:tt, $release:tt, $fence:tt) => {
- asm!(
- "2:",
- concat!("ld", $acquire, "xp {prev_lo}, {prev_hi}, [{dst}]"),
- concat!("st", $release, "xp {r:w}, {val_lo}, {val_hi}, [{dst}]"),
- // 0 if the store was successful, 1 if no store was performed
- "cbnz {r:w}, 2b",
- $fence,
- dst = in(reg) ptr_reg!(dst),
- val_lo = in(reg) val.pair.lo,
- val_hi = in(reg) val.pair.hi,
- prev_lo = out(reg) prev_lo,
- prev_hi = out(reg) prev_hi,
- r = out(reg) _,
- options(nostack, preserves_flags),
- )
- };
- }
- atomic_rmw!(swap, order);
- U128 { pair: Pair { lo: prev_lo, hi: prev_hi } }.whole
- }
-}
-
-/// Atomic RMW by LL/SC loop (3 arguments)
-/// `unsafe fn(dst: *mut u128, val: u128, order: Ordering) -> u128;`
-///
-/// `$op` can use the following registers:
-/// - val_lo/val_hi pair: val argument (read-only for `$op`)
-/// - prev_lo/prev_hi pair: previous value loaded by ll (read-only for `$op`)
-/// - new_lo/new_hi pair: new value that will be stored by sc
-macro_rules! atomic_rmw_ll_sc_3 {
- ($name:ident as $reexport_name:ident $(($preserves_flags:tt))?, $($op:tt)*) => {
- // If FEAT_LSE is available at compile-time and portable_atomic_ll_sc_rmw cfg is not set,
- // we use CAS-based atomic RMW generated by atomic_rmw_cas_3! macro instead.
- #[cfg(not(all(
- any(target_feature = "lse", portable_atomic_target_feature = "lse"),
- not(portable_atomic_ll_sc_rmw),
- )))]
- use $name as $reexport_name;
- #[cfg(any(
- test,
- not(all(
- any(target_feature = "lse", portable_atomic_target_feature = "lse"),
- not(portable_atomic_ll_sc_rmw),
- ))
- ))]
- #[inline]
- unsafe fn $name(dst: *mut u128, val: u128, order: Ordering) -> u128 {
- debug_assert!(dst as usize % 16 == 0);
- // SAFETY: the caller must uphold the safety contract.
- unsafe {
- let val = U128 { whole: val };
- let (mut prev_lo, mut prev_hi);
- macro_rules! op {
- ($acquire:tt, $release:tt, $fence:tt) => {
- asm!(
- "2:",
- concat!("ld", $acquire, "xp {prev_lo}, {prev_hi}, [{dst}]"),
- $($op)*
- concat!("st", $release, "xp {r:w}, {new_lo}, {new_hi}, [{dst}]"),
- // 0 if the store was successful, 1 if no store was performed
- "cbnz {r:w}, 2b",
- $fence,
- dst = in(reg) ptr_reg!(dst),
- val_lo = in(reg) val.pair.lo,
- val_hi = in(reg) val.pair.hi,
- prev_lo = out(reg) prev_lo,
- prev_hi = out(reg) prev_hi,
- new_lo = out(reg) _,
- new_hi = out(reg) _,
- r = out(reg) _,
- options(nostack $(, $preserves_flags)?),
- )
- };
- }
- atomic_rmw!(op, order);
- U128 { pair: Pair { lo: prev_lo, hi: prev_hi } }.whole
- }
- }
- };
-}
-/// Atomic RMW by CAS loop (3 arguments)
-/// `unsafe fn(dst: *mut u128, val: u128, order: Ordering) -> u128;`
-///
-/// `$op` can use the following registers:
-/// - val_lo/val_hi pair: val argument (read-only for `$op`)
-/// - x6/x7 pair: previous value loaded (read-only for `$op`)
-/// - x4/x5 pair: new value that will be stored
-macro_rules! atomic_rmw_cas_3 {
- ($name:ident as $reexport_name:ident, $($op:tt)*) => {
- // If FEAT_LSE is not available at compile-time or portable_atomic_ll_sc_rmw cfg is set,
- // we use LL/SC-based atomic RMW generated by atomic_rmw_ll_sc_3! macro instead.
- #[cfg(all(
- any(target_feature = "lse", portable_atomic_target_feature = "lse"),
- not(portable_atomic_ll_sc_rmw),
- ))]
- use $name as $reexport_name;
- #[cfg(any(test, not(portable_atomic_ll_sc_rmw)))]
- #[cfg(any(target_feature = "lse", portable_atomic_target_feature = "lse"))]
- #[inline]
- unsafe fn $name(dst: *mut u128, val: u128, order: Ordering) -> u128 {
- debug_assert!(dst as usize % 16 == 0);
- debug_assert_lse!();
- // SAFETY: the caller must uphold the safety contract.
- // cfg guarantee that the CPU supports FEAT_LSE.
- unsafe {
- let val = U128 { whole: val };
- let (mut prev_lo, mut prev_hi);
- macro_rules! op {
- ($acquire:tt, $release:tt, $fence:tt) => {
- asm!(
- start_lse!(),
- // If FEAT_LSE2 is not supported, this works like byte-wise atomic.
- // This is not single-copy atomic reads, but this is ok because subsequent
- // CAS will check for consistency.
- "ldp x6, x7, [{dst}]",
- "2:",
- // casp writes the current value to the first register pair,
- // so copy the `out`'s value for later comparison.
- "mov {tmp_lo}, x6",
- "mov {tmp_hi}, x7",
- $($op)*
- concat!("casp", $acquire, $release, " x6, x7, x4, x5, [{dst}]"),
- "cmp {tmp_hi}, x7",
- "ccmp {tmp_lo}, x6, #0, eq",
- "b.ne 2b",
- $fence,
- dst = in(reg) ptr_reg!(dst),
- val_lo = in(reg) val.pair.lo,
- val_hi = in(reg) val.pair.hi,
- tmp_lo = out(reg) _,
- tmp_hi = out(reg) _,
- // must be allocated to even/odd register pair
- out("x6") prev_lo,
- out("x7") prev_hi,
- // must be allocated to even/odd register pair
- out("x4") _,
- out("x5") _,
- // Do not use `preserves_flags` because CMP and CCMP modify the condition flags.
- options(nostack),
- )
- };
- }
- atomic_rmw!(op, order);
- U128 { pair: Pair { lo: prev_lo, hi: prev_hi } }.whole
- }
- }
- };
-}
-
-/// Atomic RMW by LL/SC loop (2 arguments)
-/// `unsafe fn(dst: *mut u128, order: Ordering) -> u128;`
-///
-/// `$op` can use the following registers:
-/// - prev_lo/prev_hi pair: previous value loaded by ll (read-only for `$op`)
-/// - new_lo/new_hi pair: new value that will be stored by sc
-macro_rules! atomic_rmw_ll_sc_2 {
- ($name:ident as $reexport_name:ident $(($preserves_flags:tt))?, $($op:tt)*) => {
- // If FEAT_LSE is available at compile-time and portable_atomic_ll_sc_rmw cfg is not set,
- // we use CAS-based atomic RMW generated by atomic_rmw_cas_2! macro instead.
- #[cfg(not(all(
- any(target_feature = "lse", portable_atomic_target_feature = "lse"),
- not(portable_atomic_ll_sc_rmw),
- )))]
- use $name as $reexport_name;
- #[cfg(any(
- test,
- not(all(
- any(target_feature = "lse", portable_atomic_target_feature = "lse"),
- not(portable_atomic_ll_sc_rmw),
- ))
- ))]
- #[inline]
- unsafe fn $name(dst: *mut u128, order: Ordering) -> u128 {
- debug_assert!(dst as usize % 16 == 0);
- // SAFETY: the caller must uphold the safety contract.
- unsafe {
- let (mut prev_lo, mut prev_hi);
- macro_rules! op {
- ($acquire:tt, $release:tt, $fence:tt) => {
- asm!(
- "2:",
- concat!("ld", $acquire, "xp {prev_lo}, {prev_hi}, [{dst}]"),
- $($op)*
- concat!("st", $release, "xp {r:w}, {new_lo}, {new_hi}, [{dst}]"),
- // 0 if the store was successful, 1 if no store was performed
- "cbnz {r:w}, 2b",
- $fence,
- dst = in(reg) ptr_reg!(dst),
- prev_lo = out(reg) prev_lo,
- prev_hi = out(reg) prev_hi,
- new_lo = out(reg) _,
- new_hi = out(reg) _,
- r = out(reg) _,
- options(nostack $(, $preserves_flags)?),
- )
- };
- }
- atomic_rmw!(op, order);
- U128 { pair: Pair { lo: prev_lo, hi: prev_hi } }.whole
- }
- }
- };
-}
-/// Atomic RMW by CAS loop (2 arguments)
-/// `unsafe fn(dst: *mut u128, order: Ordering) -> u128;`
-///
-/// `$op` can use the following registers:
-/// - x6/x7 pair: previous value loaded (read-only for `$op`)
-/// - x4/x5 pair: new value that will be stored
-macro_rules! atomic_rmw_cas_2 {
- ($name:ident as $reexport_name:ident, $($op:tt)*) => {
- // If FEAT_LSE is not available at compile-time or portable_atomic_ll_sc_rmw cfg is set,
- // we use LL/SC-based atomic RMW generated by atomic_rmw_ll_sc_3! macro instead.
- #[cfg(all(
- any(target_feature = "lse", portable_atomic_target_feature = "lse"),
- not(portable_atomic_ll_sc_rmw),
- ))]
- use $name as $reexport_name;
- #[cfg(any(test, not(portable_atomic_ll_sc_rmw)))]
- #[cfg(any(target_feature = "lse", portable_atomic_target_feature = "lse"))]
- #[inline]
- unsafe fn $name(dst: *mut u128, order: Ordering) -> u128 {
- debug_assert!(dst as usize % 16 == 0);
- debug_assert_lse!();
- // SAFETY: the caller must uphold the safety contract.
- // cfg guarantee that the CPU supports FEAT_LSE.
- unsafe {
- let (mut prev_lo, mut prev_hi);
- macro_rules! op {
- ($acquire:tt, $release:tt, $fence:tt) => {
- asm!(
- start_lse!(),
- // If FEAT_LSE2 is not supported, this works like byte-wise atomic.
- // This is not single-copy atomic reads, but this is ok because subsequent
- // CAS will check for consistency.
- "ldp x6, x7, [{dst}]",
- "2:",
- // casp writes the current value to the first register pair,
- // so copy the `out`'s value for later comparison.
- "mov {tmp_lo}, x6",
- "mov {tmp_hi}, x7",
- $($op)*
- concat!("casp", $acquire, $release, " x6, x7, x4, x5, [{dst}]"),
- "cmp {tmp_hi}, x7",
- "ccmp {tmp_lo}, x6, #0, eq",
- "b.ne 2b",
- $fence,
- dst = in(reg) ptr_reg!(dst),
- tmp_lo = out(reg) _,
- tmp_hi = out(reg) _,
- // must be allocated to even/odd register pair
- out("x6") prev_lo,
- out("x7") prev_hi,
- // must be allocated to even/odd register pair
- out("x4") _,
- out("x5") _,
- // Do not use `preserves_flags` because CMP and CCMP modify the condition flags.
- options(nostack),
- )
- };
- }
- atomic_rmw!(op, order);
- U128 { pair: Pair { lo: prev_lo, hi: prev_hi } }.whole
- }
- }
- };
-}
-
-// Do not use `preserves_flags` because ADDS modifies the condition flags.
-atomic_rmw_ll_sc_3! {
- _atomic_add_ldxp_stxp as atomic_add,
- select_le_or_be!("adds {new_lo}, {prev_lo}, {val_lo}", "adds {new_hi}, {prev_hi}, {val_hi}"),
- select_le_or_be!("adc {new_hi}, {prev_hi}, {val_hi}", "adc {new_lo}, {prev_lo}, {val_lo}"),
-}
-atomic_rmw_cas_3! {
- _atomic_add_casp as atomic_add,
- select_le_or_be!("adds x4, x6, {val_lo}", "adds x5, x7, {val_hi}"),
- select_le_or_be!("adc x5, x7, {val_hi}", "adc x4, x6, {val_lo}"),
-}
-
-// Do not use `preserves_flags` because SUBS modifies the condition flags.
-atomic_rmw_ll_sc_3! {
- _atomic_sub_ldxp_stxp as atomic_sub,
- select_le_or_be!("subs {new_lo}, {prev_lo}, {val_lo}", "subs {new_hi}, {prev_hi}, {val_hi}"),
- select_le_or_be!("sbc {new_hi}, {prev_hi}, {val_hi}", "sbc {new_lo}, {prev_lo}, {val_lo}"),
-}
-atomic_rmw_cas_3! {
- _atomic_sub_casp as atomic_sub,
- select_le_or_be!("subs x4, x6, {val_lo}", "subs x5, x7, {val_hi}"),
- select_le_or_be!("sbc x5, x7, {val_hi}", "sbc x4, x6, {val_lo}"),
-}
-
-#[cfg(not(any(target_feature = "lse128", portable_atomic_target_feature = "lse128")))]
-atomic_rmw_ll_sc_3! {
- _atomic_and_ldxp_stxp as atomic_and (preserves_flags),
- "and {new_lo}, {prev_lo}, {val_lo}",
- "and {new_hi}, {prev_hi}, {val_hi}",
-}
-#[cfg(not(any(target_feature = "lse128", portable_atomic_target_feature = "lse128")))]
-atomic_rmw_cas_3! {
- _atomic_and_casp as atomic_and,
- "and x4, x6, {val_lo}",
- "and x5, x7, {val_hi}",
-}
-#[cfg(any(target_feature = "lse128", portable_atomic_target_feature = "lse128"))]
-#[inline]
-unsafe fn atomic_and(dst: *mut u128, val: u128, order: Ordering) -> u128 {
- debug_assert!(dst as usize % 16 == 0);
-
- // SAFETY: the caller must guarantee that `dst` is valid for both writes and
- // reads, 16-byte aligned, that there are no concurrent non-atomic operations,
- // and the CPU supports FEAT_LSE128.
- //
- // Refs:
- // - https://developer.arm.com/documentation/ddi0602/2023-03/Base-Instructions/LDCLRP--LDCLRPA--LDCLRPAL--LDCLRPL--Atomic-bit-clear-on-quadword-in-memory-?lang=en
- unsafe {
- let val = U128 { whole: !val };
- let (prev_lo, prev_hi);
- macro_rules! and {
- ($acquire:tt, $release:tt, $fence:tt) => {
- asm!(
- concat!("ldclrp", $acquire, $release, " {val_lo}, {val_hi}, [{dst}]"),
- $fence,
- dst = in(reg) ptr_reg!(dst),
- val_lo = inout(reg) val.pair.lo => prev_lo,
- val_hi = inout(reg) val.pair.hi => prev_hi,
- options(nostack, preserves_flags),
- )
- };
- }
- atomic_rmw!(and, order);
- U128 { pair: Pair { lo: prev_lo, hi: prev_hi } }.whole
- }
-}
-
-atomic_rmw_ll_sc_3! {
- _atomic_nand_ldxp_stxp as atomic_nand (preserves_flags),
- "and {new_lo}, {prev_lo}, {val_lo}",
- "mvn {new_lo}, {new_lo}",
- "and {new_hi}, {prev_hi}, {val_hi}",
- "mvn {new_hi}, {new_hi}",
-}
-atomic_rmw_cas_3! {
- _atomic_nand_casp as atomic_nand,
- "and x4, x6, {val_lo}",
- "mvn x4, x4",
- "and x5, x7, {val_hi}",
- "mvn x5, x5",
-}
-
-#[cfg(not(any(target_feature = "lse128", portable_atomic_target_feature = "lse128")))]
-atomic_rmw_ll_sc_3! {
- _atomic_or_ldxp_stxp as atomic_or (preserves_flags),
- "orr {new_lo}, {prev_lo}, {val_lo}",
- "orr {new_hi}, {prev_hi}, {val_hi}",
-}
-#[cfg(not(any(target_feature = "lse128", portable_atomic_target_feature = "lse128")))]
-atomic_rmw_cas_3! {
- _atomic_or_casp as atomic_or,
- "orr x4, x6, {val_lo}",
- "orr x5, x7, {val_hi}",
-}
-#[cfg(any(target_feature = "lse128", portable_atomic_target_feature = "lse128"))]
-#[inline]
-unsafe fn atomic_or(dst: *mut u128, val: u128, order: Ordering) -> u128 {
- debug_assert!(dst as usize % 16 == 0);
-
- // SAFETY: the caller must guarantee that `dst` is valid for both writes and
- // reads, 16-byte aligned, that there are no concurrent non-atomic operations,
- // and the CPU supports FEAT_LSE128.
- //
- // Refs:
- // - https://developer.arm.com/documentation/ddi0602/2023-03/Base-Instructions/LDSETP--LDSETPA--LDSETPAL--LDSETPL--Atomic-bit-set-on-quadword-in-memory-?lang=en
- unsafe {
- let val = U128 { whole: val };
- let (prev_lo, prev_hi);
- macro_rules! or {
- ($acquire:tt, $release:tt, $fence:tt) => {
- asm!(
- concat!("ldsetp", $acquire, $release, " {val_lo}, {val_hi}, [{dst}]"),
- $fence,
- dst = in(reg) ptr_reg!(dst),
- val_lo = inout(reg) val.pair.lo => prev_lo,
- val_hi = inout(reg) val.pair.hi => prev_hi,
- options(nostack, preserves_flags),
- )
- };
- }
- atomic_rmw!(or, order);
- U128 { pair: Pair { lo: prev_lo, hi: prev_hi } }.whole
- }
-}
-
-atomic_rmw_ll_sc_3! {
- _atomic_xor_ldxp_stxp as atomic_xor (preserves_flags),
- "eor {new_lo}, {prev_lo}, {val_lo}",
- "eor {new_hi}, {prev_hi}, {val_hi}",
-}
-atomic_rmw_cas_3! {
- _atomic_xor_casp as atomic_xor,
- "eor x4, x6, {val_lo}",
- "eor x5, x7, {val_hi}",
-}
-
-atomic_rmw_ll_sc_2! {
- _atomic_not_ldxp_stxp as atomic_not (preserves_flags),
- "mvn {new_lo}, {prev_lo}",
- "mvn {new_hi}, {prev_hi}",
-}
-atomic_rmw_cas_2! {
- _atomic_not_casp as atomic_not,
- "mvn x4, x6",
- "mvn x5, x7",
-}
-
-// Do not use `preserves_flags` because NEGS modifies the condition flags.
-atomic_rmw_ll_sc_2! {
- _atomic_neg_ldxp_stxp as atomic_neg,
- select_le_or_be!("negs {new_lo}, {prev_lo}", "negs {new_hi}, {prev_hi}"),
- select_le_or_be!("ngc {new_hi}, {prev_hi}", "ngc {new_lo}, {prev_lo}"),
-}
-atomic_rmw_cas_2! {
- _atomic_neg_casp as atomic_neg,
- select_le_or_be!("negs x4, x6", "negs x5, x7"),
- select_le_or_be!("ngc x5, x7", "ngc x4, x6"),
-}
-
-// Do not use `preserves_flags` because CMP and SBCS modify the condition flags.
-atomic_rmw_ll_sc_3! {
- _atomic_max_ldxp_stxp as atomic_max,
- select_le_or_be!("cmp {val_lo}, {prev_lo}", "cmp {val_hi}, {prev_hi}"),
- select_le_or_be!("sbcs xzr, {val_hi}, {prev_hi}", "sbcs xzr, {val_lo}, {prev_lo}"),
- "csel {new_hi}, {prev_hi}, {val_hi}, lt", // select hi 64-bit
- "csel {new_lo}, {prev_lo}, {val_lo}, lt", // select lo 64-bit
-}
-atomic_rmw_cas_3! {
- _atomic_max_casp as atomic_max,
- select_le_or_be!("cmp {val_lo}, x6", "cmp {val_hi}, x7"),
- select_le_or_be!("sbcs xzr, {val_hi}, x7", "sbcs xzr, {val_lo}, x6"),
- "csel x5, x7, {val_hi}, lt", // select hi 64-bit
- "csel x4, x6, {val_lo}, lt", // select lo 64-bit
-}
-
-// Do not use `preserves_flags` because CMP and SBCS modify the condition flags.
-atomic_rmw_ll_sc_3! {
- _atomic_umax_ldxp_stxp as atomic_umax,
- select_le_or_be!("cmp {val_lo}, {prev_lo}", "cmp {val_hi}, {prev_hi}"),
- select_le_or_be!("sbcs xzr, {val_hi}, {prev_hi}", "sbcs xzr, {val_lo}, {prev_lo}"),
- "csel {new_hi}, {prev_hi}, {val_hi}, lo", // select hi 64-bit
- "csel {new_lo}, {prev_lo}, {val_lo}, lo", // select lo 64-bit
-}
-atomic_rmw_cas_3! {
- _atomic_umax_casp as atomic_umax,
- select_le_or_be!("cmp {val_lo}, x6", "cmp {val_hi}, x7"),
- select_le_or_be!("sbcs xzr, {val_hi}, x7", "sbcs xzr, {val_lo}, x6"),
- "csel x5, x7, {val_hi}, lo", // select hi 64-bit
- "csel x4, x6, {val_lo}, lo", // select lo 64-bit
-}
-
-// Do not use `preserves_flags` because CMP and SBCS modify the condition flags.
-atomic_rmw_ll_sc_3! {
- _atomic_min_ldxp_stxp as atomic_min,
- select_le_or_be!("cmp {val_lo}, {prev_lo}", "cmp {val_hi}, {prev_hi}"),
- select_le_or_be!("sbcs xzr, {val_hi}, {prev_hi}", "sbcs xzr, {val_lo}, {prev_lo}"),
- "csel {new_hi}, {prev_hi}, {val_hi}, ge", // select hi 64-bit
- "csel {new_lo}, {prev_lo}, {val_lo}, ge", // select lo 64-bit
-}
-atomic_rmw_cas_3! {
- _atomic_min_casp as atomic_min,
- select_le_or_be!("cmp {val_lo}, x6", "cmp {val_hi}, x7"),
- select_le_or_be!("sbcs xzr, {val_hi}, x7", "sbcs xzr, {val_lo}, x6"),
- "csel x5, x7, {val_hi}, ge", // select hi 64-bit
- "csel x4, x6, {val_lo}, ge", // select lo 64-bit
-}
-
-// Do not use `preserves_flags` because CMP and SBCS modify the condition flags.
-atomic_rmw_ll_sc_3! {
- _atomic_umin_ldxp_stxp as atomic_umin,
- select_le_or_be!("cmp {val_lo}, {prev_lo}", "cmp {val_hi}, {prev_hi}"),
- select_le_or_be!("sbcs xzr, {val_hi}, {prev_hi}", "sbcs xzr, {val_lo}, {prev_lo}"),
- "csel {new_hi}, {prev_hi}, {val_hi}, hs", // select hi 64-bit
- "csel {new_lo}, {prev_lo}, {val_lo}, hs", // select lo 64-bit
-}
-atomic_rmw_cas_3! {
- _atomic_umin_casp as atomic_umin,
- select_le_or_be!("cmp {val_lo}, x6", "cmp {val_hi}, x7"),
- select_le_or_be!("sbcs xzr, {val_hi}, x7", "sbcs xzr, {val_lo}, x6"),
- "csel x5, x7, {val_hi}, hs", // select hi 64-bit
- "csel x4, x6, {val_lo}, hs", // select lo 64-bit
-}
-
-#[inline]
-const fn is_lock_free() -> bool {
- IS_ALWAYS_LOCK_FREE
-}
-const IS_ALWAYS_LOCK_FREE: bool = true;
-
-atomic128!(AtomicI128, i128, atomic_max, atomic_min);
-atomic128!(AtomicU128, u128, atomic_umax, atomic_umin);
-
-#[cfg(test)]
-mod tests {
- use super::*;
-
- test_atomic_int!(i128);
- test_atomic_int!(u128);
-
- // load/store/swap implementation is not affected by signedness, so it is
- // enough to test only unsigned types.
- stress_test!(u128);
-}