Struct calloop::signals::Signals

pub struct Signals { /* private fields */ }

Available on Linux only.

An event source for receiving Unix signals

Implementations

impl Signals

pub fn new(signals: &[Signal]) -> Result<Signals>

Create a new signal event source listening on the specified list of signals

pub fn add_signals(&mut self, signals: &[Signal]) -> Result<()>

Add a list of signals to the signals source

If this function returns an error, the signal mask of the thread may have still been changed.

pub fn remove_signals(&mut self, signals: &[Signal]) -> Result<()>

Remove a list of signals from the signals source

If this function returns an error, the signal mask of the thread may have still been changed.

pub fn set_signals(&mut self, signals: &[Signal]) -> Result<()>

Replace the list of signals of the source

If this function returns an error, the signal mask of the thread may have still been changed.

Trait Implementations

impl Debug for Signals

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

Formats the value using the given formatter.

impl Drop for Signals

fn drop(&mut self)

Executes the destructor for this type.

impl EventSource for Signals

type Event = Event

The type of events generated by your source.

type Metadata = ()

Some metadata of your event source

type Ret = ()

The return type of the user callback

type Error = SignalError

The error type returned from process_events() (not the user callback!).

fn process_events<C>( &mut self, readiness: Readiness, token: Token, callback: C ) -> Result<PostAction, Self::Error>

where C: FnMut(Self::Event, &mut Self::Metadata) -> Self::Ret,

Process any relevant events

fn register( &mut self, poll: &mut Poll, token_factory: &mut TokenFactory ) -> Result<()>

Register yourself to this poll instance

fn reregister( &mut self, poll: &mut Poll, token_factory: &mut TokenFactory ) -> Result<()>

Re-register your file descriptors

fn unregister(&mut self, poll: &mut Poll) -> Result<()>

Unregister your file descriptors

const NEEDS_EXTRA_LIFECYCLE_EVENTS: bool = false

Whether this source needs to be sent the EventSource::before_sleep and EventSource::before_handle_events notifications. These are opt-in because they require more expensive checks, and almost all sources will not need these notifications

fn before_sleep(&mut self) -> Result<Option<(Readiness, Token)>>

Notification that a single poll is about to begin

fn before_handle_events(&mut self, events: EventIterator<'_>)

Notification that polling is complete, and EventSource::process_events will be called with the given events for this source. The iterator may be empty, which indicates that no events were generated for this source