Struct RawSpinLock 

pub struct RawSpinLock<T>(/* private fields */)
where
    T: ?Sized;

A non-sleeping mutual-exclusion lock.

The lock object does not bake in an execution-context policy. Callers choose the policy at the acquisition site with Self::lock, Self::lock_irqsave, or Self::lock_raw.

Implementations

impl<T> RawSpinLock<T>

pub const fn new(data: T) -> RawSpinLock<T>

Creates an unlocked spin lock.

pub fn into_inner(self) -> T

Consumes the lock and returns the protected value.

impl<T> RawSpinLock<T>

where T: ?Sized,

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

Acquires the lock after disabling kernel preemption.

pub fn lock_nested( &self, subclass: u32, ) -> BaseSpinLockGuard<'_, PreemptState, T>

Acquires the lock after disabling preemption, using a lockdep subclass.

This is intended for structurally nested acquisitions of different locks with the same class. Without lockdep, subclass has no effect.

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

Attempts to acquire the lock after disabling kernel preemption.

pub fn lock_irqsave(&self) -> BaseSpinLockGuard<'_, PreemptIrqSaveState, T>

Acquires the lock after disabling preemption and saving/disabling IRQs.

pub fn lock_irqsave_nested( &self, subclass: u32, ) -> BaseSpinLockGuard<'_, PreemptIrqSaveState, T>

Acquires the lock after disabling preemption and saving/disabling IRQs, using a lockdep subclass.

This is intended for structurally nested acquisitions of different locks with the same class. Without lockdep, subclass has no effect.

pub fn try_lock_irqsave( &self, ) -> Option<BaseSpinLockGuard<'_, PreemptIrqSaveState, T>>

Attempts to acquire the lock after disabling preemption and IRQs.

pub unsafe fn lock_raw(&self) -> BaseSpinLockGuard<'_, RawState, T>

Acquires the lock without changing preemption or interrupt state.

Safety

The caller must prevent same-CPU re-entry and all concurrent access which could violate exclusive access, including on single-core builds where the atomic lock word is compiled out.

pub unsafe fn try_lock_raw(&self) -> Option<BaseSpinLockGuard<'_, RawState, T>>

Attempts a raw acquisition without changing execution context.

Safety

The caller must uphold the same exclusion contract as Self::lock_raw, even when this function returns None.

pub fn is_locked(&self) -> bool

Returns whether the lock appears held.

This is only a diagnostic snapshot and provides no synchronization.

pub fn get_mut(&mut self) -> &mut T

Returns mutable access without locking.

Trait Implementations

impl<T> Debug for RawSpinLock<T>

where T: Debug,

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

Formats the value using the given formatter.

impl<T> Default for RawSpinLock<T>

where T: Default,

fn default() -> RawSpinLock<T>

Returns the “default value” for a type.