Struct esp_idf_svc::hal::task::notification::Notifier

pub struct Notifier(/* private fields */);

Implementations

impl Notifier

pub unsafe fn notify(&self, notification: NonZero<u32>) -> (bool, bool)

Safety

This method is unsafe because it is possible to call core::mem::forget on the Monitor instance that produced this notifier.

If that happens, the Drop dtor of Monitor will NOT be called, which - in turn - means that the Arc holding the task reference will stick around even when the actual task where the Monitor instance was created no longer exists. Which - in turn - would mean that the method will be trying to notify a task which does no longer exist, which would lead to UB and specifically - to memory corruption.

pub unsafe fn notify_and_yield(&self, notification: NonZero<u32>) -> bool

Safety

This method is unsafe because it is possible to call core::mem::forget on the Monitor instance that produced this notifier.

If that happens, the Drop dtor of Monitor will NOT be called, which - in turn - means that the Arc holding the task reference will stick around even when the actual task where the Monitor instance was created no longer exists. Which - in turn - would mean that the method will be trying to notify a task which does no longer exist, which would lead to UB and specifically - to memory corruption.

Trait Implementations

impl Wake for Notifier

fn wake(self: Arc<Notifier>)

Wake this task.

fn wake_by_ref(self: &Arc<Self>)

Wake this task without consuming the waker.