tokio-file

Crates.iotokio-file
lib.rstokio-file
version0.10.0
sourcesrc
created_at2017-07-26 03:34:41.30414
updated_at2024-05-25 12:53:58.292142
descriptionAsynchronous file I/O for Tokio
homepage
repositoryhttps://github.com/asomers/tokio-file
max_upload_size
id25103
size68,588
Alan Somers (asomers)

documentation

README

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.

Build Status Crates.io

Documentation

# Cargo.toml
[depdendencies]
tokio = "1.0.0"
tokio-file = "0.10.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::AioFileExt and running the resulting futures in the tokio reactor.

Platforms

tokio-file version 0.10 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.

Commit count: 236

cargo fmt