Struct mio::event::Event

source ·
#[repr(transparent)]
pub struct Event { inner: epoll_event, }
Expand description

A readiness event.

Event is a readiness state paired with a Token. It is returned by Poll::poll.

For more documentation on polling and events, see Poll.

Fields§

§inner: epoll_event

Implementations§

source§

impl Event

source

pub fn token(&self) -> Token

Returns the event’s token.

source

pub fn is_readable(&self) -> bool

Returns true if the event contains readable readiness.

Notes

Out-of-band (OOB) data also triggers readable events. But must application don’t actually read OOB data, this could leave an application open to a Denial-of-Service (Dos) attack, see https://github.com/sandstorm-io/sandstorm-website/blob/58f93346028c0576e8147627667328eaaf4be9fa/_posts/2015-04-08-osx-security-bug.md. However because Mio uses edge-triggers it will not result in an infinite loop as described in the article above.

source

pub fn is_writable(&self) -> bool

Returns true if the event contains writable readiness.

source

pub fn is_error(&self) -> bool

Returns true if the event contains error readiness.

Error events occur when the socket enters an error state. In this case, the socket will also receive a readable or writable event. Reading or writing to the socket will result in an error.

Notes

Method is available on all platforms, but not all platforms trigger the error event.

The table below shows what flags are checked on what OS.

OS selectorFlag(s) checked
epollEPOLLERR
kqueueEV_ERROR and EV_EOF with fflags set to 0.
source

pub fn is_read_closed(&self) -> bool

Returns true if the event contains read closed readiness.

Notes

Read closed readiness can be expected after any of the following have occurred:

  • The local stream has shutdown the read half of its socket
  • The local stream has shutdown both the read half and the write half of its socket
  • The peer stream has shutdown the write half its socket; this sends a FIN packet that has been received by the local stream

Method is a best effort implementation. While some platforms may not return readiness when read half is closed, it is guaranteed that false-positives will not occur.

The table below shows what flags are checked on what OS.

OS selectorFlag(s) checked
epollEPOLLHUP, or
EPOLLIN and EPOLLRDHUP
kqueueEV_EOF
source

pub fn is_write_closed(&self) -> bool

Returns true if the event contains write closed readiness.

Notes

On epoll this is essentially a check for EPOLLHUP flag as the local stream shutting down its write half does not trigger this event.

On kqueue the local stream shutting down the write half of its socket will trigger this event.

Method is a best effort implementation. While some platforms may not return readiness when write half is closed, it is guaranteed that false-positives will not occur.

The table below shows what flags are checked on what OS.

OS selectorFlag(s) checked
epollEPOLLHUP, or
only EPOLLERR, or
EPOLLOUT and EPOLLERR
kqueueEV_EOF
source

pub fn is_priority(&self) -> bool

Returns true if the event contains priority readiness.

Notes

Method is available on all platforms, but not all platforms trigger the priority event.

The table below shows what flags are checked on what OS.

OS selectorFlag(s) checked
epollEPOLLPRI
kqueueNot supported
source

pub fn is_aio(&self) -> bool

Returns true if the event contains AIO readiness.

Notes

Method is available on all platforms, but not all platforms support AIO.

The table below shows what flags are checked on what OS.

OS selectorFlag(s) checked
epollNot supported
kqueue1EVFILT_AIO

1: Only supported on DragonFly BSD, FreeBSD, iOS and macOS.

source

pub fn is_lio(&self) -> bool

Returns true if the event contains LIO readiness.

Notes

Method is available on all platforms, but only FreeBSD supports LIO. On FreeBSD this method checks the EVFILT_LIO flag.

source

pub(crate) fn from_sys_event_ref(sys_event: &epoll_event) -> &Event

Create a reference to an Event from a platform specific event.

Trait Implementations§

source§

impl Clone for Event

source§

fn clone(&self) -> Event

Returns a copy of the value. Read more
1.0.0 · source§

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source. Read more
source§

impl Debug for Event

When the alternate flag is enabled this will print platform specific details, for example the fields of the kevent structure on platforms that use kqueue(2). Note however that the output of this implementation is not consider a part of the stable API.

source§

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

Formats the value using the given formatter. Read more

Auto Trait Implementations§

§

impl RefUnwindSafe for Event

§

impl Send for Event

§

impl Sync for Event

§

impl Unpin for Event

§

impl UnwindSafe for Event

Blanket Implementations§

source§

impl<T> Any for Twhere T: 'static + ?Sized,

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

impl<T> Borrow<T> for Twhere T: ?Sized,

source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

impl<T> BorrowMut<T> for Twhere T: ?Sized,

source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

Returns the argument unchanged.

source§

impl<T, U> Into<U> for Twhere U: From<T>,

source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

source§

impl<T> ToOwned for Twhere T: Clone,

§

type Owned = T

The resulting type after obtaining ownership.
source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
source§

impl<T, U> TryFrom<U> for Twhere U: Into<T>,

§

type Error = Infallible

The type returned in the event of a conversion error.
source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

impl<T, U> TryInto<U> for Twhere U: TryFrom<T>,

§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.