tokio-file
tokio-file copied to clipboard
Asynchronous file I/O for Tokio
tokio-file
A library for integrating file I/O with tokio. File I/O can be seamlessly mixed with all other Future types within the Tokio reactor.
# Cargo.toml
[depdendencies]
tokio = "1.0.0"
tokio-file = "0.8.0"
Usage
See the examples
directory in the repository. In general, any program that's
already using tokio
can add file I/O by using tokio_file::File
and
running the resulting futures in the tokio reactor.
Platforms
tokio-file
version 0.7 works on FreeBSD, using the mio-aio
crate. It will
probably also work on DragonflyBSD and OSX. It does not work on Linux. The
tokio-file
API can be supported on Linux, but it will need a completely
different backend. Instead of using POSIX AIO as mio-aio
does, Linux will
need a mio-libaio
crate, that uses Linux's nonstandard libaio with an eventfd
for notifications. That's the approach taken by seastar.
License
tokio-file
is primarily distributed under the terms of both the MIT license
and the Apache License (Version 2.0).
See LICENSE-APACHE, and LICENSE-MIT for details.