Struct KMutexGuardMultiple 

pub struct KMutexGuardMultiple<'a, const N: usize, Class: LockClass, M: RawLock = RawMutex, P: LockPolicy<M> = <M as RawLock>::DefaultPolicy> { /* private fields */ }

Guards simultaneous acquisitions of multiple locks of the same class and type.

Locks are automatically sorted in-place by ascending memory address before acquisition to preserve the intra-class ordering invariant and prevent AB/BA deadlocks, matching C++ lockdep::GuardMultiple.

Implementations

impl<'a, const N: usize, Class: LockClass, M: RawLock, P: LockPolicy<M>> KMutexGuardMultiple<'a, N, Class, M, P>

pub fn project<'__pin>( self: Pin<&'__pin mut Self>, ) -> KMutexGuardMultipleProjection<'__pin, 'a, N, Class, M, P>

Pin-projects all fields of Self.

These fields are structurally pinned:

• lock_entries

These fields are not structurally pinned:

• mutexes
• states
• tokens

impl<'a, const N: usize, Class: LockClass, M: RawLock, P: LockPolicy<M>> KMutexGuardMultiple<'a, N, Class, M, P>

pub fn new(locks: [&'a KMutex<Class, M>; N]) -> impl PinInit<Self, Infallible>

where P: LockPolicy<M, AcquireArgs = ()>,

Creates a new stack-pinned multi-lock validation guard initialization block.

pub fn new_with_args( locks: [&'a KMutex<Class, M>; N], args: P::AcquireArgs, ) -> impl PinInit<Self, Infallible>

Creates a new stack-pinned multi-lock validation guard initialization block with policy acquire arguments.

pub fn tokens(&self) -> &[LockToken<'a, Class>; N]

Returns shared references to the lock proof tokens.

pub fn tokens_mut(self: Pin<&mut Self>) -> &mut [LockToken<'a, Class>; N]

Returns mutable references to the lock proof tokens.

pub fn release(self: Pin<&mut Self>)

Explicitly releases all held locks in reverse order before the guard is dropped.

If the locks have already been released, this is a no-op.

Trait Implementations

impl<'a, const N: usize, Class: LockClass, M: RawLock, P: LockPolicy<M>> Drop for KMutexGuardMultiple<'a, N, Class, M, P>

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.

impl<'a, const N: usize, Class: LockClass, M: RawLock, P: LockPolicy<M>> HasPinData for KMutexGuardMultiple<'a, N, Class, M, P>

type PinData = __ThePinData<'a, N, Class, M, P>

unsafe fn __pin_data() -> Self::PinData

impl<'a, const N: usize, Class: LockClass, M: RawLock, P: LockPolicy<M>> PinnedDrop for KMutexGuardMultiple<'a, N, Class, M, P>

fn drop(self: Pin<&mut Self>, _: OnlyCallFromDrop)

Executes the pinned destructor of this type.