//! Helper module that wraps some Mutex types with different implementations. //! //! When the `single_threaded` feature is on the mutexes will panic when locked from different threads. #[cfg(not(any(feature = "single_threaded", feature = "multi_threaded")))] compile_error!("Either feature \"single_threaded\" or \"multi_threaded\" must be enabled."); // ---------------------------------------------------------------------------- /// Provides interior mutability. Only thread-safe if the `multi_threaded` feature is enabled. #[cfg(feature = "multi_threaded")] #[derive(Default)] pub struct Mutex(parking_lot::Mutex); /// The lock you get from [`Mutex`]. #[cfg(feature = "multi_threaded")] #[cfg(not(debug_assertions))] pub use parking_lot::MutexGuard; /// The lock you get from [`Mutex`]. #[cfg(feature = "multi_threaded")] #[cfg(debug_assertions)] pub struct MutexGuard<'a, T>(parking_lot::MutexGuard<'a, T>, *const ()); #[cfg(all(debug_assertions, feature = "multi_threaded"))] #[derive(Default)] struct HeldLocks(Vec<*const ()>); #[cfg(all(debug_assertions, feature = "multi_threaded"))] impl HeldLocks { fn insert(&mut self, lock: *const ()) { // Very few locks will ever be held at the same time, so a linear search is fast assert!( !self.0.contains(&lock), "Recursively locking a Mutex in the same thread is not supported" ); self.0.push(lock); } fn remove(&mut self, lock: *const ()) { self.0.retain(|&ptr| ptr != lock); } } #[cfg(all(debug_assertions, feature = "multi_threaded"))] thread_local! { static HELD_LOCKS_TLS: std::cell::RefCell = Default::default(); } #[cfg(feature = "multi_threaded")] impl Mutex { #[inline(always)] pub fn new(val: T) -> Self { Self(parking_lot::Mutex::new(val)) } #[cfg(debug_assertions)] pub fn lock(&self) -> MutexGuard<'_, T> { // Detect if we are recursively taking out a lock on this mutex. // use a pointer to the inner data as an id for this lock let ptr = (&self.0 as *const parking_lot::Mutex<_>).cast::<()>(); // Store it in thread local storage while we have a lock guard taken out HELD_LOCKS_TLS.with(|held_locks| { held_locks.borrow_mut().insert(ptr); }); MutexGuard(self.0.lock(), ptr) } #[inline(always)] #[cfg(not(debug_assertions))] pub fn lock(&self) -> MutexGuard<'_, T> { self.0.lock() } } #[cfg(debug_assertions)] #[cfg(feature = "multi_threaded")] impl Drop for MutexGuard<'_, T> { fn drop(&mut self) { let ptr = self.1; HELD_LOCKS_TLS.with(|held_locks| { held_locks.borrow_mut().remove(ptr); }); } } #[cfg(debug_assertions)] #[cfg(feature = "multi_threaded")] impl std::ops::Deref for MutexGuard<'_, T> { type Target = T; #[inline(always)] fn deref(&self) -> &Self::Target { &self.0 } } #[cfg(debug_assertions)] #[cfg(feature = "multi_threaded")] impl std::ops::DerefMut for MutexGuard<'_, T> { #[inline(always)] fn deref_mut(&mut self) -> &mut Self::Target { &mut self.0 } } // --------------------- /// The lock you get from [`RwLock::read`]. #[cfg(feature = "multi_threaded")] pub use parking_lot::RwLockReadGuard; /// The lock you get from [`RwLock::write`]. #[cfg(feature = "multi_threaded")] pub use parking_lot::RwLockWriteGuard; /// Provides interior mutability. Only thread-safe if the `multi_threaded` feature is enabled. #[cfg(feature = "multi_threaded")] #[derive(Default)] pub struct RwLock(parking_lot::RwLock); #[cfg(feature = "multi_threaded")] impl RwLock { #[inline(always)] pub fn new(val: T) -> Self { Self(parking_lot::RwLock::new(val)) } #[inline(always)] pub fn read(&self) -> RwLockReadGuard<'_, T> { self.0.read() } #[inline(always)] pub fn write(&self) -> RwLockWriteGuard<'_, T> { self.0.write() } } // ---------------------------------------------------------------------------- // `atomic_refcell` will panic if multiple threads try to access the same value /// The lock you get from [`Mutex`]. #[cfg(not(feature = "multi_threaded"))] pub use atomic_refcell::AtomicRefMut as MutexGuard; /// Provides interior mutability. Only thread-safe if the `multi_threaded` feature is enabled. #[cfg(not(feature = "multi_threaded"))] #[derive(Default)] pub struct Mutex(atomic_refcell::AtomicRefCell); #[cfg(not(feature = "multi_threaded"))] impl Mutex { #[inline(always)] pub fn new(val: T) -> Self { Self(atomic_refcell::AtomicRefCell::new(val)) } /// Panics if already locked. #[inline(always)] pub fn lock(&self) -> MutexGuard<'_, T> { self.0.borrow_mut() } } // --------------------- /// The lock you get from [`RwLock::read`]. #[cfg(not(feature = "multi_threaded"))] pub use atomic_refcell::AtomicRef as RwLockReadGuard; /// The lock you get from [`RwLock::write`]. #[cfg(not(feature = "multi_threaded"))] pub use atomic_refcell::AtomicRefMut as RwLockWriteGuard; /// Provides interior mutability. Only thread-safe if the `multi_threaded` feature is enabled. #[cfg(not(feature = "multi_threaded"))] #[derive(Default)] pub struct RwLock(atomic_refcell::AtomicRefCell); #[cfg(not(feature = "multi_threaded"))] impl RwLock { #[inline(always)] pub fn new(val: T) -> Self { Self(atomic_refcell::AtomicRefCell::new(val)) } #[inline(always)] pub fn read(&self) -> RwLockReadGuard<'_, T> { self.0.borrow() } /// Panics if already locked. #[inline(always)] pub fn write(&self) -> RwLockWriteGuard<'_, T> { self.0.borrow_mut() } } // ---------------------------------------------------------------------------- impl Clone for Mutex where T: Clone, { fn clone(&self) -> Self { Self::new(self.lock().clone()) } } #[cfg(test)] mod tests { use crate::mutex::Mutex; use std::time::Duration; #[test] fn lock_two_different_mutexes_single_thread() { let one = Mutex::new(()); let two = Mutex::new(()); let _a = one.lock(); let _b = two.lock(); } #[test] #[should_panic] fn lock_reentry_single_thread() { let one = Mutex::new(()); let _a = one.lock(); let _a2 = one.lock(); // panics } #[test] fn lock_multiple_threads() { use std::sync::Arc; let one = Arc::new(Mutex::new(())); let our_lock = one.lock(); let other_thread = { let one = Arc::clone(&one); std::thread::spawn(move || { let _ = one.lock(); }) }; std::thread::sleep(Duration::from_millis(200)); drop(our_lock); other_thread.join().unwrap(); } }