• rculock A [[https://en.wikipedia.org/wiki/Read-copy-update][read-copy-update]] lock using [[https://aturon.github.io/blog/2015/08/27/epoch/][epoch-based reclamation]] through [[https://github.com/aturon/crossbeam][crossbeam]].

The API is similar to =std::sync::RwLock=. Reads are lock-free and never block. Writes update the data protected by the lock only when the write guard is dropped.

See [[https://docs.rs/rculock/][documentation]] for more details.

** Example

+BEGIN_SRC rust

use rculock::{RcuLock, RcuGuard};

// Create a new RcuLock protecting a piece of data, in this case a number (u32). let data: RcuLock = RcuLock::new(5); asserteq!(5, *data.read()); { // The data is cloned and handed to the writer let mut guard: RcuGuard = data.write(); // RcuGuard implements Deref and DerefMut for easy access to the data. *guard = 4; // The writer has changed its copy of the data, but the changes // have not yet made it back to the master RcuLock. asserteq!(5, *data.read()); } // After the write guard is dropped, the state of the resource // as the writer sees it is atomically stored back into the master RcuLock. assert_eq!(4, *data.read());

+END_SRC