Skip to content
GitHub no longer supports this web browser. Learn more about the browsers we support.
Rust interface to io_uring
Rust
Branch: master
Clone or download
withoutboats Merge pull request #32 from twissel/additional-methods
Prep methods for additional io_uring features
Latest commit 17de5a5 Jan 23, 2020
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
props Bindings for liburing Nov 6, 2019
src Merge branch 'master' into additional-methods Jan 22, 2020
tests Merge branch 'master' into additional-methods Jan 22, 2020
.gitignore Bindings for liburing Nov 6, 2019
CODE_OF_CONDUCT.md Code of Conduct Nov 8, 2019
Cargo.toml progress Dec 26, 2019
LICENSE-APACHE Add metadata Nov 6, 2019
LICENSE-MIT Add metadata Nov 6, 2019
README.md Kernel support note in README Nov 7, 2019

README.md

Interface to Linux's io_uring interface

iou is a wrapper around the liburing library, which provides a high level interface to Linux's new io_uring interface. It is intended to be extensible and flexible for any use case of io_uring, while still resolving many of the basic safety issues on users' behalf.

The primary API of iou is the IoUring type and its components, the SubmissionQueue, CompletionQueue and Registrar. This provides a Rust-like and high level API that manages the io_uring for you.

Safety

Most of the APIs in iou are safe, and many of the safety issues in using io_uring are completely resolved. In particular, the liburing library which iou is based on correctly implements the atomics necessary to coordinate with the kernel across the io_uring interface. However, some key interfaces remain unsafe. In particular, preparing IO events to be submitted to the io_uring is not safe: users must ensure that the buffers and file descriptors are regarded as borrowed during the lifetime of the IO.

Kernel support

In order to use io_uring, the machine you are running your code on must have a kernel which supports that interface. The first version of io_uring was added in Linux 5.1, but it did not include all of the features supported by this library. Some features of this library may not work depending on which version of Linux you are using.

You can’t perform that action at this time.