#futex #mutex #rwlock #condvar #linux

no-std rustix-futex-sync

Linux futex-based synchronization

10 releases

0.2.3 Aug 27, 2024
0.2.2 Jun 12, 2024
0.2.1 Dec 4, 2023
0.1.5 Oct 9, 2023
0.1.3 Aug 27, 2023

#102 in Concurrency

Download history 184/week @ 2024-08-17 269/week @ 2024-08-24 76/week @ 2024-08-31 29/week @ 2024-09-07 61/week @ 2024-09-14 117/week @ 2024-09-21 151/week @ 2024-09-28 754/week @ 2024-10-05 178/week @ 2024-10-12 205/week @ 2024-10-19 78/week @ 2024-10-26 55/week @ 2024-11-02 63/week @ 2024-11-09 83/week @ 2024-11-16 181/week @ 2024-11-23 83/week @ 2024-11-30

410 downloads per month
Used in 11 crates (5 directly)

Apache-2.0…

88KB
975 lines

rustix-futex-sync

Linux futex-based synchronization

Github Actions CI Status zulip chat crates.io page docs.rs docs

Linux futex-based implementations of Mutex, RwLock, Condvar, Once, and OnceLock, as well as RawMutex, RawRwLock, and RawCondvar, derived from the futex code in std, factored out to a standalone no_std crate using rustix to do the futex and lock_api to provide most of the public Mutex and RwLock API.

lock_api does not support poisoning, so support for poisoning is omitted.

In this library, Condvar, RawCondvar, RawMutex, and Once are guaranteed to be repr(transparent) wrappers around a single AtomicU32. RawRwLock is guaranteed to be a repr(C) wrapper around two AtomicU32s. The contents of these AtomicU32s are not documented, except that all these types' const fn new() and INIT are guaranteed to initialize them to all zeros.

Dependencies

~2–10MB
~119K SLoC