rio

• 文档 * 聊天 * 赞助

rio 旨在利用 Rust 的编译时检查来提高对误用的抵御能力,与其他语言中的 io_uring 接口相比,但用户应注意,在使用 rio 时,unsafe 仍然可能导致use-after-free 错误。**Completion 会借用请求中涉及的缓冲区,其析构函数会阻塞,以延迟释放这些缓冲区,直到相应的请求完成;但在 Rust 中,它被认为是安全的,对象的生命周期内的借用不会导致其析构函数运行,并且这可能以各种方式发生,包括通过 std::mem::forget。请注意不要让完成函数以这种方式泄露,如果 Rust 的可靠性保证对您很重要,您可能会想避免使用此 crate。

创新

• 只依赖 libc,无需使用 c/bindgen 来复杂化事情,没有人想要这样做
• 完成函数在线程或异步运行时工作非常好(Completion 实现了 Future)
• 使用 Rust 标记特性来保证缓冲区永远不会被写入,除非它是可写内存。(防止您尝试将数据写入静态只读内存)
• 没有必要直接操作 IoSlice 或 libc::iovec。rio 会在后台为您维护这些内容。
• 如果允许 io_uring 独立运行,它将允许您提交的 IO 操作数量超过完成队列可容纳的数量,从而导致丢弃完成并造成等待完成的用户空间对象泄露。rio 会在正在运行的请求数达到此阈值时对提交者施加反压,以保证不会因为完成队列溢出而丢弃完成。