Struct Srcu 

pub struct Srcu { /* private fields */ }

Sleepable read-copy update primitive.

SRCU readers may sleep while holding the read-side guard.

The destructor waits for active readers and callbacks, so it may sleep. If a read-side guard has been leaked, dropping an Srcu may never return.

Invariants

This represents a valid struct srcu_struct initialized by the C SRCU API and it remains pinned and valid until the pinned destructor runs.

Implementations

impl Srcu

pub fn project<'__pin>(self: Pin<&'__pin mut Self>) -> SrcuProjection<'__pin>

Pin-projects all fields of Self.

These fields are structurally pinned:

• inner

These fields are not structurally pinned:

impl Srcu

pub fn new( name: &'static CStr, key: Pin<&'static LockClassKey>, ) -> impl PinInit<Self, Error>

Creates a new SRCU instance.

pub fn read_lock(&self) -> Guard<'_>

Enters an SRCU read-side critical section.

Leaking the returned Guard leaves the SRCU read-side critical section active and makes drop sleep forever.

pub fn synchronize(&self)

Waits until all pre-existing SRCU readers have completed.

pub fn synchronize_expedited(&self)

Waits until all pre-existing SRCU readers have completed, expedited.

This requests a lower-latency grace period than Srcu::synchronize typically at the cost of higher system-wide overhead. Prefer Srcu::synchronize by default and use this variant only when reducing reset or teardown latency is more important than the extra cost.

Trait Implementations

impl Drop for Srcu

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 HasPinData for Srcu

type PinData = __ThePinData

unsafe fn __pin_data() -> Self::PinData

impl PinnedDrop for Srcu

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

Executes the pinned destructor of this type.

impl Send for Srcu

impl Sync for Srcu