dope_core/driver/schedule/
maint.rs

1use std::{marker, mem};
2
3use o3::{base::marker::ThreadBound, mem::quota};
4use state::lanes;
5
6use crate::driver::schedule::state;
7
8#[derive(Clone, Copy)]
9#[repr(transparent)]
10pub struct Work<'turn, 'd> {
11    pub(in crate::driver::schedule) state: &'turn state::Core<'d>,
12}
13
14#[must_use = "a maintenance permit represents one admitted transition"]
15pub struct Permit<'turn, 'd> {
16    proof: marker::PhantomData<(&'turn mut (), crate::driver::Invariant<'d>, ThreadBound)>,
17}
18
19impl<'turn, 'd> Work<'turn, 'd> {
20    pub fn remaining(self) -> usize {
21        self.state.lanes.maint.remaining()
22    }
23
24    pub fn run<T>(self, run: impl FnOnce() -> Option<T>) -> quota::Admission<T> {
25        self.state.lanes.maint.admit_with(run)
26    }
27
28    pub fn permit(self) -> Option<Permit<'turn, 'd>> {
29        match self.state.lanes.maint.take() {
30            quota::Take::Taken => Some(Permit::new()),
31            quota::Take::Exhausted => None,
32        }
33    }
34
35    pub fn claim<T>(
36        self,
37        claim: impl FnOnce() -> Option<T>,
38    ) -> quota::Admission<(T, Permit<'turn, 'd>)> {
39        self.run(|| claim().map(|value| (value, Permit::new())))
40    }
41
42    pub fn share<const N: usize, T>(self, run: impl FnOnce() -> T) -> T {
43        let _held = lanes::share::<N, _>(&self.state.lanes.maint, 0);
44        run()
45    }
46}
47
48impl<'turn, 'd> Permit<'turn, 'd> {
49    fn new() -> Self {
50        Self {
51            proof: marker::PhantomData,
52        }
53    }
54
55    pub fn run<T>(self, run: impl FnOnce() -> T) -> T {
56        run()
57    }
58}
59
60const _: () = {
61    let word = mem::size_of::<usize>();
62    assert!(mem::size_of::<Work<'static, 'static>>() == word);
63    assert!(mem::size_of::<Permit<'static, 'static>>() == 0);
64};
dope_core/driver/schedule/maint.rs

dope_core/driver/schedule/
maint.rs
