|
|
@ -1,24 +1,11 @@
|
|
|
|
use std::cell::UnsafeCell;
|
|
|
|
use async_rwlock::{
|
|
|
|
|
|
|
|
RwLock as RawRwLock, RwLockReadGuard as RawRwLockReadGuard,
|
|
|
|
|
|
|
|
RwLockWriteGuard as RawRwLockWriteGuard,
|
|
|
|
|
|
|
|
};
|
|
|
|
|
|
|
|
|
|
|
|
use std::fmt;
|
|
|
|
use std::fmt;
|
|
|
|
use std::isize;
|
|
|
|
|
|
|
|
use std::ops::{Deref, DerefMut};
|
|
|
|
use std::ops::{Deref, DerefMut};
|
|
|
|
use std::pin::Pin;
|
|
|
|
use std::sync::atomic::Ordering;
|
|
|
|
use std::process;
|
|
|
|
|
|
|
|
use std::future::Future;
|
|
|
|
|
|
|
|
use std::sync::atomic::{AtomicUsize, Ordering};
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
use crate::sync::WakerSet;
|
|
|
|
|
|
|
|
use crate::task::{Context, Poll};
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
/// Set if a write lock is held.
|
|
|
|
|
|
|
|
#[allow(clippy::identity_op)]
|
|
|
|
|
|
|
|
const WRITE_LOCK: usize = 1 << 0;
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
/// The value of a single blocked read contributing to the read count.
|
|
|
|
|
|
|
|
const ONE_READ: usize = 1 << 1;
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
/// The bits in which the read count is stored.
|
|
|
|
|
|
|
|
const READ_COUNT_MASK: usize = !(ONE_READ - 1);
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
/// A reader-writer lock for protecting shared data.
|
|
|
|
/// A reader-writer lock for protecting shared data.
|
|
|
|
///
|
|
|
|
///
|
|
|
@ -50,10 +37,7 @@ const READ_COUNT_MASK: usize = !(ONE_READ - 1);
|
|
|
|
/// # })
|
|
|
|
/// # })
|
|
|
|
/// ```
|
|
|
|
/// ```
|
|
|
|
pub struct RwLock<T: ?Sized> {
|
|
|
|
pub struct RwLock<T: ?Sized> {
|
|
|
|
state: AtomicUsize,
|
|
|
|
inner: RawRwLock<T>,
|
|
|
|
read_wakers: WakerSet,
|
|
|
|
|
|
|
|
write_wakers: WakerSet,
|
|
|
|
|
|
|
|
value: UnsafeCell<T>,
|
|
|
|
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
unsafe impl<T: ?Sized + Send> Send for RwLock<T> {}
|
|
|
|
unsafe impl<T: ?Sized + Send> Send for RwLock<T> {}
|
|
|
@ -70,11 +54,8 @@ impl<T> RwLock<T> {
|
|
|
|
/// let lock = RwLock::new(0);
|
|
|
|
/// let lock = RwLock::new(0);
|
|
|
|
/// ```
|
|
|
|
/// ```
|
|
|
|
pub fn new(t: T) -> RwLock<T> {
|
|
|
|
pub fn new(t: T) -> RwLock<T> {
|
|
|
|
RwLock {
|
|
|
|
Self {
|
|
|
|
state: AtomicUsize::new(0),
|
|
|
|
inner: RawRwLock::new(t),
|
|
|
|
read_wakers: WakerSet::new(),
|
|
|
|
|
|
|
|
write_wakers: WakerSet::new(),
|
|
|
|
|
|
|
|
value: UnsafeCell::new(t),
|
|
|
|
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
@ -101,58 +82,7 @@ impl<T: ?Sized> RwLock<T> {
|
|
|
|
/// # })
|
|
|
|
/// # })
|
|
|
|
/// ```
|
|
|
|
/// ```
|
|
|
|
pub async fn read(&self) -> RwLockReadGuard<'_, T> {
|
|
|
|
pub async fn read(&self) -> RwLockReadGuard<'_, T> {
|
|
|
|
pub struct ReadFuture<'a, T: ?Sized> {
|
|
|
|
self.inner.read()
|
|
|
|
lock: &'a RwLock<T>,
|
|
|
|
|
|
|
|
opt_key: Option<usize>,
|
|
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
impl<'a, T: ?Sized> Future for ReadFuture<'a, T> {
|
|
|
|
|
|
|
|
type Output = RwLockReadGuard<'a, T>;
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
fn poll(mut self: Pin<&mut Self>, cx: &mut Context<'_>) -> Poll<Self::Output> {
|
|
|
|
|
|
|
|
loop {
|
|
|
|
|
|
|
|
// If the current task is in the set, remove it.
|
|
|
|
|
|
|
|
if let Some(key) = self.opt_key.take() {
|
|
|
|
|
|
|
|
self.lock.read_wakers.remove(key);
|
|
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
// Try acquiring a read lock.
|
|
|
|
|
|
|
|
match self.lock.try_read() {
|
|
|
|
|
|
|
|
Some(guard) => return Poll::Ready(guard),
|
|
|
|
|
|
|
|
None => {
|
|
|
|
|
|
|
|
// Insert this lock operation.
|
|
|
|
|
|
|
|
self.opt_key = Some(self.lock.read_wakers.insert(cx));
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
// If the lock is still acquired for writing, return.
|
|
|
|
|
|
|
|
if self.lock.state.load(Ordering::SeqCst) & WRITE_LOCK != 0 {
|
|
|
|
|
|
|
|
return Poll::Pending;
|
|
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
impl<T: ?Sized> Drop for ReadFuture<'_, T> {
|
|
|
|
|
|
|
|
fn drop(&mut self) {
|
|
|
|
|
|
|
|
// If the current task is still in the set, that means it is being cancelled now.
|
|
|
|
|
|
|
|
if let Some(key) = self.opt_key {
|
|
|
|
|
|
|
|
self.lock.read_wakers.cancel(key);
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
// If there are no active readers, notify a blocked writer if none were
|
|
|
|
|
|
|
|
// notified already.
|
|
|
|
|
|
|
|
if self.lock.state.load(Ordering::SeqCst) & READ_COUNT_MASK == 0 {
|
|
|
|
|
|
|
|
self.lock.write_wakers.notify_any();
|
|
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
ReadFuture {
|
|
|
|
|
|
|
|
lock: self,
|
|
|
|
|
|
|
|
opt_key: None,
|
|
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
.await
|
|
|
|
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
/// Attempts to acquire a read lock.
|
|
|
|
/// Attempts to acquire a read lock.
|
|
|
@ -179,30 +109,7 @@ impl<T: ?Sized> RwLock<T> {
|
|
|
|
/// # })
|
|
|
|
/// # })
|
|
|
|
/// ```
|
|
|
|
/// ```
|
|
|
|
pub fn try_read(&self) -> Option<RwLockReadGuard<'_, T>> {
|
|
|
|
pub fn try_read(&self) -> Option<RwLockReadGuard<'_, T>> {
|
|
|
|
let mut state = self.state.load(Ordering::SeqCst);
|
|
|
|
self.inner.try_read()
|
|
|
|
|
|
|
|
|
|
|
|
loop {
|
|
|
|
|
|
|
|
// If a write lock is currently held, then a read lock cannot be acquired.
|
|
|
|
|
|
|
|
if state & WRITE_LOCK != 0 {
|
|
|
|
|
|
|
|
return None;
|
|
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
// Make sure the number of readers doesn't overflow.
|
|
|
|
|
|
|
|
if state > isize::MAX as usize {
|
|
|
|
|
|
|
|
process::abort();
|
|
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
// Increment the number of active reads.
|
|
|
|
|
|
|
|
match self.state.compare_exchange_weak(
|
|
|
|
|
|
|
|
state,
|
|
|
|
|
|
|
|
state + ONE_READ,
|
|
|
|
|
|
|
|
Ordering::SeqCst,
|
|
|
|
|
|
|
|
Ordering::SeqCst,
|
|
|
|
|
|
|
|
) {
|
|
|
|
|
|
|
|
Ok(_) => return Some(RwLockReadGuard(self)),
|
|
|
|
|
|
|
|
Err(s) => state = s,
|
|
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
/// Acquires a write lock.
|
|
|
|
/// Acquires a write lock.
|
|
|
@ -226,55 +133,7 @@ impl<T: ?Sized> RwLock<T> {
|
|
|
|
/// # })
|
|
|
|
/// # })
|
|
|
|
/// ```
|
|
|
|
/// ```
|
|
|
|
pub async fn write(&self) -> RwLockWriteGuard<'_, T> {
|
|
|
|
pub async fn write(&self) -> RwLockWriteGuard<'_, T> {
|
|
|
|
pub struct WriteFuture<'a, T: ?Sized> {
|
|
|
|
self.inner.write()
|
|
|
|
lock: &'a RwLock<T>,
|
|
|
|
|
|
|
|
opt_key: Option<usize>,
|
|
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
impl<'a, T: ?Sized> Future for WriteFuture<'a, T> {
|
|
|
|
|
|
|
|
type Output = RwLockWriteGuard<'a, T>;
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
fn poll(mut self: Pin<&mut Self>, cx: &mut Context<'_>) -> Poll<Self::Output> {
|
|
|
|
|
|
|
|
loop {
|
|
|
|
|
|
|
|
// If the current task is in the set, remove it.
|
|
|
|
|
|
|
|
if let Some(key) = self.opt_key.take() {
|
|
|
|
|
|
|
|
self.lock.write_wakers.remove(key);
|
|
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
// Try acquiring a write lock.
|
|
|
|
|
|
|
|
match self.lock.try_write() {
|
|
|
|
|
|
|
|
Some(guard) => return Poll::Ready(guard),
|
|
|
|
|
|
|
|
None => {
|
|
|
|
|
|
|
|
// Insert this lock operation.
|
|
|
|
|
|
|
|
self.opt_key = Some(self.lock.write_wakers.insert(cx));
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
// If the lock is still acquired for reading or writing, return.
|
|
|
|
|
|
|
|
if self.lock.state.load(Ordering::SeqCst) != 0 {
|
|
|
|
|
|
|
|
return Poll::Pending;
|
|
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
impl<T: ?Sized> Drop for WriteFuture<'_, T> {
|
|
|
|
|
|
|
|
fn drop(&mut self) {
|
|
|
|
|
|
|
|
// If the current task is still in the set, that means it is being cancelled now.
|
|
|
|
|
|
|
|
if let Some(key) = self.opt_key {
|
|
|
|
|
|
|
|
if !self.lock.write_wakers.cancel(key) {
|
|
|
|
|
|
|
|
// If no other blocked reader was notified, notify all readers.
|
|
|
|
|
|
|
|
self.lock.read_wakers.notify_all();
|
|
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
WriteFuture {
|
|
|
|
|
|
|
|
lock: self,
|
|
|
|
|
|
|
|
opt_key: None,
|
|
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
.await
|
|
|
|
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
/// Attempts to acquire a write lock.
|
|
|
|
/// Attempts to acquire a write lock.
|
|
|
@ -301,11 +160,7 @@ impl<T: ?Sized> RwLock<T> {
|
|
|
|
/// # })
|
|
|
|
/// # })
|
|
|
|
/// ```
|
|
|
|
/// ```
|
|
|
|
pub fn try_write(&self) -> Option<RwLockWriteGuard<'_, T>> {
|
|
|
|
pub fn try_write(&self) -> Option<RwLockWriteGuard<'_, T>> {
|
|
|
|
if self.state.compare_and_swap(0, WRITE_LOCK, Ordering::SeqCst) == 0 {
|
|
|
|
self.inner.try_write()
|
|
|
|
Some(RwLockWriteGuard(self))
|
|
|
|
|
|
|
|
} else {
|
|
|
|
|
|
|
|
None
|
|
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
/// Consumes the lock, returning the underlying data.
|
|
|
|
/// Consumes the lock, returning the underlying data.
|
|
|
@ -318,8 +173,11 @@ impl<T: ?Sized> RwLock<T> {
|
|
|
|
/// let lock = RwLock::new(10);
|
|
|
|
/// let lock = RwLock::new(10);
|
|
|
|
/// assert_eq!(lock.into_inner(), 10);
|
|
|
|
/// assert_eq!(lock.into_inner(), 10);
|
|
|
|
/// ```
|
|
|
|
/// ```
|
|
|
|
pub fn into_inner(self) -> T where T: Sized {
|
|
|
|
pub fn into_inner(self) -> T
|
|
|
|
self.value.into_inner()
|
|
|
|
where
|
|
|
|
|
|
|
|
T: Sized,
|
|
|
|
|
|
|
|
{
|
|
|
|
|
|
|
|
self.inner.into_inner()
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
/// Returns a mutable reference to the underlying data.
|
|
|
|
/// Returns a mutable reference to the underlying data.
|
|
|
@ -341,23 +199,13 @@ impl<T: ?Sized> RwLock<T> {
|
|
|
|
/// # })
|
|
|
|
/// # })
|
|
|
|
/// ```
|
|
|
|
/// ```
|
|
|
|
pub fn get_mut(&mut self) -> &mut T {
|
|
|
|
pub fn get_mut(&mut self) -> &mut T {
|
|
|
|
unsafe { &mut *self.value.get() }
|
|
|
|
self.inner.get_mut()
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
impl<T: ?Sized + fmt::Debug> fmt::Debug for RwLock<T> {
|
|
|
|
impl<T: ?Sized + fmt::Debug> fmt::Debug for RwLock<T> {
|
|
|
|
fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
|
|
|
|
fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
|
|
|
|
struct Locked;
|
|
|
|
self.inner.fmt(f)
|
|
|
|
impl fmt::Debug for Locked {
|
|
|
|
|
|
|
|
fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
|
|
|
|
|
|
|
|
f.write_str("<locked>")
|
|
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
match self.try_read() {
|
|
|
|
|
|
|
|
None => f.debug_struct("RwLock").field("data", &Locked).finish(),
|
|
|
|
|
|
|
|
Some(guard) => f.debug_struct("RwLock").field("data", &&*guard).finish(),
|
|
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
@ -374,31 +222,26 @@ impl<T: ?Sized + Default> Default for RwLock<T> {
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
/// A guard that releases the read lock when dropped.
|
|
|
|
/// A guard that releases the read lock when dropped.
|
|
|
|
pub struct RwLockReadGuard<'a, T: ?Sized>(&'a RwLock<T>);
|
|
|
|
pub struct RwLockReadGuard<'a, T: ?Sized>(&'a RawRwLockReadGuard<T>);
|
|
|
|
|
|
|
|
|
|
|
|
unsafe impl<T: ?Sized + Send> Send for RwLockReadGuard<'_, T> {}
|
|
|
|
unsafe impl<T: ?Sized + Send> Send for RwLockReadGuard<'_, T> {}
|
|
|
|
unsafe impl<T: ?Sized + Sync> Sync for RwLockReadGuard<'_, T> {}
|
|
|
|
unsafe impl<T: ?Sized + Sync> Sync for RwLockReadGuard<'_, T> {}
|
|
|
|
|
|
|
|
|
|
|
|
impl<T: ?Sized> Drop for RwLockReadGuard<'_, T> {
|
|
|
|
impl<T: ?Sized> Drop for RwLockReadGuard<'_, T> {
|
|
|
|
fn drop(&mut self) {
|
|
|
|
fn drop(&mut self) {
|
|
|
|
let state = self.0.state.fetch_sub(ONE_READ, Ordering::SeqCst);
|
|
|
|
self.0.drop()
|
|
|
|
|
|
|
|
|
|
|
|
// If this was the last reader, notify a blocked writer if none were notified already.
|
|
|
|
|
|
|
|
if state & READ_COUNT_MASK == ONE_READ {
|
|
|
|
|
|
|
|
self.0.write_wakers.notify_any();
|
|
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
impl<T: ?Sized + fmt::Debug> fmt::Debug for RwLockReadGuard<'_, T> {
|
|
|
|
impl<T: ?Sized + fmt::Debug> fmt::Debug for RwLockReadGuard<'_, T> {
|
|
|
|
fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
|
|
|
|
fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
|
|
|
|
fmt::Debug::fmt(&**self, f)
|
|
|
|
self.0.fmt(f)
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
impl<T: ?Sized + fmt::Display> fmt::Display for RwLockReadGuard<'_, T> {
|
|
|
|
impl<T: ?Sized + fmt::Display> fmt::Display for RwLockReadGuard<'_, T> {
|
|
|
|
fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
|
|
|
|
fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
|
|
|
|
(**self).fmt(f)
|
|
|
|
self.0.fmt(f)
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
@ -406,7 +249,7 @@ impl<T: ?Sized> Deref for RwLockReadGuard<'_, T> {
|
|
|
|
type Target = T;
|
|
|
|
type Target = T;
|
|
|
|
|
|
|
|
|
|
|
|
fn deref(&self) -> &T {
|
|
|
|
fn deref(&self) -> &T {
|
|
|
|
unsafe { &*self.0.value.get() }
|
|
|
|
self.0.deref()
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|