Struct DynamicRcuLock 

pub struct DynamicRcuLock<T> { /* private fields */ }

A synchronization wrapper that combines an RCU primitive T with a DynamicLockDepMutex to serialize updates while permitting lock-free RCU reads, without using types for lock levels.

Readers access the underlying RCU value without acquiring the mutex via the read methods on DynamicRcuLock. Writers must acquire the mutex via DynamicRcuLock::lock or DynamicRcuLock::try_lock to obtain an RcuLockGuard, which grants exclusive writer access to T.

Implementations

impl<T> DynamicRcuLock<T>

pub const fn new<L: LockLevel>(rcu: T) -> Self

Creates a new DynamicRcuLock wrapping rcu at lock level L.

pub fn lock(&self) -> RcuLockGuard<'_, T>

Acquires the update lock and returns a guard that allows updating the RCU cell.

pub fn try_lock(&self) -> Option<RcuLockGuard<'_, T>>

Attempts to acquire the update lock without blocking.

impl<T: Send + Sync + 'static> DynamicRcuLock<RcuArc<T>>

pub fn upgrade(&self) -> Option<Arc<T>>

Reads the contents of the underlying RcuArc without acquiring the update lock.

Returns None if the wrapped Arc is None or is no longer valid.

pub fn is_some(&self) -> bool

Returns true if the underlying RcuArc currently contains a value.

pub fn is_none(&self) -> bool

Returns true if the underlying RcuArc does not contain a value.

impl<T: RcuDroppable + Sync> DynamicRcuLock<RcuArray<T>>

pub fn get<'a>(&self, scope: &'a RcuReadScope, index: usize) -> Option<&'a T>

Returns a reference to the element at index, or None if index is out of bounds.

pub fn as_slice<'a>(&self, scope: &'a RcuReadScope) -> &'a [T]

Returns a slice containing the entire array bound to scope.

impl<T: RcuDroppable + Sync> DynamicRcuLock<RcuBox<T>>

pub fn read(&self) -> RcuReadGuard<T>

Reads the value of the wrapped RcuBox without acquiring the update lock.

pub fn as_ref<'a>(&self, scope: &'a RcuReadScope) -> &'a T

Returns a reference to the value of the wrapped RcuBox bound to scope.

pub fn cloned(&self) -> T

where T: Clone,

Returns a clone of the value of the wrapped RcuBox.

impl<T: RcuDroppable + Sync> DynamicRcuLock<RcuDroppableArc<T>>

pub fn read(&self) -> RcuReadGuard<T>

Reads the value of the wrapped RcuDroppableArc without acquiring the update lock.

pub fn as_ref<'a>(&self, scope: &'a RcuReadScope) -> &'a T

Returns a reference to the value of the wrapped RcuDroppableArc bound to scope.

pub fn to_arc(&self) -> Arc<T>

Creates a new Arc<T> referencing the same object as the underlying RcuDroppableArc.

impl<T: RcuDroppable + Sync> DynamicRcuLock<RcuOptionArc<T>>

pub fn read(&self) -> Option<RcuReadGuard<T>>

Reads the value of the wrapped RcuOptionArc without acquiring the update lock.

pub fn as_ref<'a>(&self, scope: &'a RcuReadScope) -> Option<&'a T>

Returns a reference to the value of the wrapped RcuOptionArc bound to scope.

pub fn to_option_arc(&self) -> Option<Arc<T>>

Creates a new Option<Arc<T>> referencing the same object as the underlying RcuOptionArc.

impl<T: RcuDroppable + Sync> DynamicRcuLock<RcuOptionBox<T>>

pub fn read(&self) -> Option<RcuReadGuard<T>>

Reads the value of the wrapped RcuOptionBox without acquiring the update lock.

pub fn as_ref<'a>(&self, scope: &'a RcuReadScope) -> Option<&'a T>

Returns a reference to the value of the wrapped RcuOptionBox bound to scope.

pub fn is_some(&self, scope: &RcuReadScope) -> bool

Returns true if the underlying RcuOptionBox currently contains a value.

pub fn is_none(&self, scope: &RcuReadScope) -> bool

Returns true if the underlying RcuOptionBox does not contain a value.

pub fn cloned(&self) -> Option<T>

where T: Clone,

Returns a clone of the value of the wrapped RcuOptionBox.

impl<T: Send + Sync + 'static> DynamicRcuLock<RcuWeak<T>>

pub fn upgrade(&self) -> Option<Arc<T>>

Attempts to upgrade the wrapped Weak pointer to an Arc without acquiring the update lock.

pub fn to_weak(&self) -> Weak<T>

Creates a new Weak pointer to the object referenced by the underlying RcuWeak.

pub fn ptr_eq(&self, other: &Weak<T>) -> bool

Returns true if the wrapped weak pointer points to the same allocation as other.

pub fn strong_count(&self, scope: &RcuReadScope) -> usize

Returns the number of strong (Arc) pointers pointing to the allocation.

Trait Implementations

impl<T: Debug> Debug for DynamicRcuLock<T>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<T> MutexLike for DynamicRcuLock<T>

type Guard<'a> = RcuLockGuard<'a, T> where T: 'a

type Context = <DynamicLockDepMutex<()> as MutexLike>::Context

fn context() -> Self::Context

fn lock(&self, context: &mut Self::Context) -> Self::Guard<'_>

Lock the mutex. level is the index of the locked mutex in the lock ordering.

fn key(&self) -> *const ()

where Self: Sized,

impl<T> RcuDroppable for DynamicRcuLock<T>

where T: RcuDroppable, DynamicLockDepMutex<()>: RcuDroppable,

impl<T> ResetDependencies for DynamicRcuLock<T>

unsafe fn reset_dependencies(&self)

Resets the lock dependency graph for this lock.