Need help with polling?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

189 Stars 22 Forks Other 134 Commits 3 Opened issues


Portable interface to epoll, kqueue, event ports, and wepoll

Services available


Need anything else?

Contributors list


Build License Cargo Documentation

Portable interface to epoll, kqueue, event ports, and wepoll.

Supported platforms: - epoll: Linux, Android - kqueue: macOS, iOS, FreeBSD, NetBSD, OpenBSD, DragonFly BSD - event ports: illumos, Solaris - poll: VxWorks, Fuchsia, other Unix systems - wepoll: Windows

Polling is done in oneshot mode, which means interest in I/O events needs to be reset after an event is delivered if we're interested in the next event of the same kind.

Only one thread can be waiting for I/O events at a time.


use polling::{Event, Poller};
use std::net::TcpListener;

// Create a TCP listener. let socket = TcpListener::bind("")?; socket.set_nonblocking(true)?; let key = 7; // Arbitrary key identifying the socket.

// Create a poller and register interest in readability on the socket. let poller = Poller::new()?; poller.add(&socket, Event::readable(key))?;

// The event loop. let mut events = Vec::new(); loop { // Wait for at least one I/O event. events.clear(); poller.wait(&mut events, None)?;

for ev in &events {
    if ev.key == key {
        // Perform a non-blocking accept operation.
        // Set interest in the next readability event.
        poller.modify(&socket, Event::readable(key))?;



Licensed under either of

  • Apache License, Version 2.0 (LICENSE-APACHE or
  • MIT license (LICENSE-MIT or

at your option.


Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.