Module jlrs::gc_safe

GC-safe synchronization primitives.

Naively using synchronization primitives like OnceLock or Mutex from a thread that belongs to Julia is dangerous. If the GC needs to collect garbage while a thread is waiting to acquire such a primitive you can end up with a deadlock. We can prevent this from happening by entering a GC-safe state before blocking and leaving that state as soon as we wake up.

This module offers the following GC-safe synchronization primitives: GcSafeOnceLock, GcSafeRwLock, GcSafeMutex, and GcSafeFairMutex. All of them guarantee the calling thread is in a GC-safe state while it is blocked.

Re-exports

• pub use fair_mutex::GcSafeFairMutex;
• pub use mutex::GcSafeMutex;
• pub use once_lock::GcSafeOnceLock;
• pub use rwlock::GcSafeRwLock;

Modules

• fair_mutex
  A GC-safe FairMutex.
• mutex
  A GC-safe Mutex.
• once_lock
  A GC-safe OnceLock.
• rwlock
  A GC-safe RwLock.

Structs

• RawGcSafeFairMutex
  See parking_lot::RawFairMutex for more information.
• RawGcSafeMutex
  See parking_lot::RawMutex for more information.
• RawGcSafeRwLock
  See parking_lot::RawRwLock for more information.