#concurrency #value #rcu #latest #thread #shared #shared-data

genzero

genzero is a library that lets you get the latest value of a type

2 unstable releases

0.2.0 Aug 9, 2024
0.1.0 Jun 18, 2024

#335 in Unix APIs

43 downloads per month

MPL-2.0 license

12KB
163 lines

genzero

genzero is a library that lets you get the latest value of a type.

Why genzero?

There are many concurrency programs where one may have many reader threads that want to get the latest value of a type that is being updated by another thread (spmc). A naive approach would be using a Mutex/RWLock on the shared piece of data. Locks are unfortunately slow in many cases and specifically don't allow us to maximize throughput. RCU is a technique initially developed in the linux kernel that allows the pattern described above while not blocking the writers and increasing throughput (Fedor Pikus CppCon 2017 Talk on RCU). crossbeam-epoch is an epoch based memory reclaimer that implements an RCU method for Rust. genzero is an API to achieve this simple spmc latest value pattern built on top of the crossbeam-epoch library.

How to use genzero?

genzero's API is similar to a crossbeam::channel or a std:sync::mpsc

Simple Example

// Initialize first value to 0
let (mut tx, rx) = genzero::new<u32>(0);

tx.send(10);

assert_eq!(rx.recv(), Some(10));

Dependencies

~270KB