Struct TimelineChangeObserver 

pub struct TimelineChangeObserver { /* private fields */ }

Used to observe timeline changes from within TimerOps.

Implementations

impl TimelineChangeObserver

pub fn new( timeline_change_counter: Counter, timeline_change_registration: UnboundedSender<bool>, ) -> Self

pub fn reset_timeline_change_counter(&self) -> i64

Resets the change counter, and returns the observed value.

The reset is done in such a way that any “sets” that come while “reset” is running does not lose a “set”.

What is expected here is that at the end either (1) COUNTER_POSITIVE is cleared, or (2) if it happens not to be cleared due to a race, that Starnix has a way to probe the COUNTER_POSITIVE and react again if it remains asserted (without being strobed to zero) after this call returns.

(2) happens to be true today due to how file ops work, and will likely continue to be so. But it’s a tad bit disconcerting that the correct operation of this counter depends on two bits of code that are somewhat far away from each other. A safer alternative would be a “counter swap” operation that would write a value and return the old value atomically, but that does not exist today.

pub fn get_timeline_change_counter_ref(&self) -> &Counter

pub fn set_timeline_change_interest(&mut self, is_interested: bool)

Trait Implementations

impl Debug for TimelineChangeObserver

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Drop for TimelineChangeObserver

fn drop(&mut self)

Executes the destructor for this type.