Google Git
Sign in
fuchsia / third_party / mio / b6dde86ef9989615394bbb8bcd36ca454dbd7847
commitb6dde86ef9989615394bbb8bcd36ca454dbd7847[log] [tgz]
authorTaylor Cramer <cramertaylorj@gmail.com>Mon Jul 17 15:51:12 2017 -0700
committerAlex Crichton <alex@alexcrichton.com>Mon Jul 17 17:51:12 2017 -0500
tree44a8d3824eea666b3142afb450b47fb958a587ce
parenta5415ba319e1bef09980f972caf4ffc9bf92d5b4 [diff]
Fuchsia port (#629)

* Fuchsia Shell

* Selector

* Working selector and awakener

* A bunch more crap

* Impl UdpSocket and add comments

* UdpSocket fixup

* Initial TCP

* All tests passing

* Start cleanup

* Separate out modules

* Add EventedHandle and fuchsia_channel test

* Remove unused [feature]

* Add only v6 methods and fixup reregistration of EventedFds

* Remove dependency on concurrent_hashmap

* Don't overwrite existing tokens

* panic -> err

* Remove unnecessary pub restrictions and document unsafety

* Fix privacy error and convert panic on invalid token into err

* Use saturating ops for time modification

* Cleanup EventedFd registration

* Replace Events Option with Vec

* Use accessors rather than pub fields

* Clear up unnecessary repeating events on reregistered handles

* Fix orderings

* Cleanup

* Backcompat with rust 1.9
23 files changed
tree: 44a8d3824eea666b3142afb450b47fb958a587ce
  1. benches/
  2. ci/
  3. src/
  4. test/
  5. .gitignore
  6. .travis.yml
  7. appveyor.yml
  8. Cargo.toml
  9. CHANGELOG.md
  10. LICENSE
  11. README.md
README.md

Mio - Metal IO

Mio is a lightweight I/O library for Rust with a focus on adding as little overhead as possible over the OS abstractions.

crates.io Build Status Build status

API documentation

This is a low level library, if you are looking for something easier to get started with, see Tokio.

Usage

To use mio, first add this to your Cargo.toml:

[dependencies]
mio = "0.6"

Then, add this to your crate root:

extern crate mio;

Features

  • Event loop backed by epoll, kqueue.
  • Zero allocations at runtime
  • Non-blocking TCP, UDP and Unix domain sockets
  • High performance timer system
  • Thread safe message channel for cross thread communication

Non goals

The following are specifically omitted from MIO and are left to the user or higher level libraries.

  • File operations
  • Thread pools / multi-threaded event loop

Platforms

Currently supported platforms:

  • Linux
  • OS X
  • Windows
  • NetBSD
  • Android
  • iOS

There are potentially others. If you find that Mio works on another platform, submit a PR to update the list!

Libraries

  • tokio-core - Underlying event loop for the Tokio project.
  • mioco - Mio COroutines
  • simplesched - Coroutine I/O with a simple scheduler
  • coio-rs - Coroutine I/O with work-stealing scheduler
  • rotor - A wrapper that allows to create composable I/O libraries on top of mio
  • ws-rs - WebSockets based on Mio

Community

A group of mio users hang out in the #mio channel on the Mozilla IRC server (irc.mozilla.org). This can be a good place to go for questions.

Contributing

Interested in getting involved? We would love to help you! For simple bug fixes, just submit a PR with the fix and we can discuss the fix directly in the PR. If the fix is more complex, start with an issue.

If you want to propose an API change, create an issue to start a discussion with the community. Also, feel free to talk with us in the IRC channel.

Finally, be kind. We support the Rust Code of Conduct.