LCOV - code coverage report
Current view: top level - libs/desim/src - time.rs (source / functions) Coverage Total Hit
Test: a43a77853355b937a79c57b07a8f05607cf29e6c.info Lines: 90.2 % 61 55
Test Date: 2024-09-19 12:04:32 Functions: 83.3 % 12 10

            Line data    Source code
       1              : use std::{
       2              :     cmp::Ordering,
       3              :     collections::BinaryHeap,
       4              :     ops::DerefMut,
       5              :     sync::{
       6              :         atomic::{AtomicU32, AtomicU64},
       7              :         Arc,
       8              :     },
       9              : };
      10              : 
      11              : use parking_lot::Mutex;
      12              : use tracing::trace;
      13              : 
      14              : use crate::executor::ThreadContext;
      15              : 
      16              : /// Holds current time and all pending wakeup events.
      17              : pub struct Timing {
      18              :     /// Current world's time.
      19              :     current_time: AtomicU64,
      20              :     /// Pending timers.
      21              :     queue: Mutex<BinaryHeap<Pending>>,
      22              :     /// Global nonce. Makes picking events from binary heap queue deterministic
      23              :     /// by appending a number to events with the same timestamp.
      24              :     nonce: AtomicU32,
      25              :     /// Used to schedule fake events.
      26              :     fake_context: Arc<ThreadContext>,
      27              : }
      28              : 
      29              : impl Default for Timing {
      30            0 :     fn default() -> Self {
      31            0 :         Self::new()
      32            0 :     }
      33              : }
      34              : 
      35              : impl Timing {
      36              :     /// Create a new empty clock with time set to 0.
      37         2028 :     pub fn new() -> Timing {
      38         2028 :         Timing {
      39         2028 :             current_time: AtomicU64::new(0),
      40         2028 :             queue: Mutex::new(BinaryHeap::new()),
      41         2028 :             nonce: AtomicU32::new(0),
      42         2028 :             fake_context: Arc::new(ThreadContext::new()),
      43         2028 :         }
      44         2028 :     }
      45              : 
      46              :     /// Return the current world's time.
      47      8249704 :     pub fn now(&self) -> u64 {
      48      8249704 :         self.current_time.load(std::sync::atomic::Ordering::SeqCst)
      49      8249704 :     }
      50              : 
      51              :     /// Tick-tock the global clock. Return the event ready to be processed
      52              :     /// or move the clock forward and then return the event.
      53       855020 :     pub(crate) fn step(&self) -> Option<Arc<ThreadContext>> {
      54       855020 :         let mut queue = self.queue.lock();
      55       855020 : 
      56       855020 :         if queue.is_empty() {
      57              :             // no future events
      58         2048 :             return None;
      59       852972 :         }
      60       852972 : 
      61       852972 :         if !self.is_event_ready(queue.deref_mut()) {
      62       629519 :             let next_time = queue.peek().unwrap().time;
      63       629519 :             self.current_time
      64       629519 :                 .store(next_time, std::sync::atomic::Ordering::SeqCst);
      65       629519 :             trace!("rewind time to {}", next_time);
      66       629519 :             assert!(self.is_event_ready(queue.deref_mut()));
      67       223453 :         }
      68              : 
      69       852972 :         Some(queue.pop().unwrap().wake_context)
      70       855020 :     }
      71              : 
      72              :     /// Append an event to the queue, to wakeup the thread in `ms` milliseconds.
      73       802532 :     pub(crate) fn schedule_wakeup(&self, ms: u64, wake_context: Arc<ThreadContext>) {
      74       802532 :         self.nonce.fetch_add(1, std::sync::atomic::Ordering::SeqCst);
      75       802532 :         let nonce = self.nonce.load(std::sync::atomic::Ordering::SeqCst);
      76       802532 :         self.queue.lock().push(Pending {
      77       802532 :             time: self.now() + ms,
      78       802532 :             nonce,
      79       802532 :             wake_context,
      80       802532 :         })
      81       802532 :     }
      82              : 
      83              :     /// Append a fake event to the queue, to prevent clocks from skipping this time.
      84       100588 :     pub fn schedule_fake(&self, ms: u64) {
      85       100588 :         self.queue.lock().push(Pending {
      86       100588 :             time: self.now() + ms,
      87       100588 :             nonce: 0,
      88       100588 :             wake_context: self.fake_context.clone(),
      89       100588 :         });
      90       100588 :     }
      91              : 
      92              :     /// Return true if there is a ready event.
      93      1482491 :     fn is_event_ready(&self, queue: &mut BinaryHeap<Pending>) -> bool {
      94      1482491 :         queue.peek().map_or(false, |x| x.time <= self.now())
      95      1482491 :     }
      96              : 
      97              :     /// Clear all pending events.
      98         2003 :     pub(crate) fn clear(&self) {
      99         2003 :         self.queue.lock().clear();
     100         2003 :     }
     101              : }
     102              : 
     103              : struct Pending {
     104              :     time: u64,
     105              :     nonce: u32,
     106              :     wake_context: Arc<ThreadContext>,
     107              : }
     108              : 
     109              : // BinaryHeap is a max-heap, and we want a min-heap. Reverse the ordering here
     110              : // to get that.
     111              : impl PartialOrd for Pending {
     112      6956018 :     fn partial_cmp(&self, other: &Self) -> Option<Ordering> {
     113      6956018 :         Some(self.cmp(other))
     114      6956018 :     }
     115              : }
     116              : 
     117              : impl Ord for Pending {
     118      6956018 :     fn cmp(&self, other: &Self) -> Ordering {
     119      6956018 :         (other.time, other.nonce).cmp(&(self.time, self.nonce))
     120      6956018 :     }
     121              : }
     122              : 
     123              : impl PartialEq for Pending {
     124            0 :     fn eq(&self, other: &Self) -> bool {
     125            0 :         (other.time, other.nonce) == (self.time, self.nonce)
     126            0 :     }
     127              : }
     128              : 
     129              : impl Eq for Pending {}
        

Generated by: LCOV version 2.1-beta