#smart-pointers #thread-local #counter #atomic #global #rc #require

mlsp

Mlsp is a small library for smart pointers that use both thread local and global atomic counters

3 unstable releases

0.2.0 Dec 18, 2021
0.1.1 Dec 18, 2021
0.1.0 Dec 18, 2021

#561 in Concurrency

24 downloads per month

MIT license

11KB
162 lines

Toy Badge

Multi-Level Smart Pointers

The Multi-Level Smart Pointer uses an atomic global reference counter and per-thread non-atomic reference counters. The goal is that an MLSP should outperform a purely-atomicly counted smart pointer when enough local copies are performed.

Mlsp

The Mlsp type can be used like Rc for sharing memory within one thread. It does not implement Send and cannot be sent between threads, so any clone() and drop() operations performed on it use the local counter (except the last drop in a given thread).

The benefit of an Mlsp over an Rc is that repackaging it to share it with another thread does not require copying or moving the underlying data, it is already being stored in a way and with a counter that can be used to share between threads.

MlspPackage

To send an Mlsp to another thread, you must make an MlspPackage. The MlspPackage type does implement Send and is ready to be sent to other threads. Receiving threads then use to create a new Mlsp with its own local reference counter.

let a = Mlsp::new(1u8).package();

thread::spawn(move || {
    let a2 = a; // Valid because MlspPackage implements Send
    println!("{:?}", a.unpackage().borrow());
})

Benchmarking and Testing

This library is still in need of extensive benchmarking and testing to demonstrate that it is robust and effective.

No runtime deps