Linux io_uring 怎样等待文件描述符事件
来源:17golang原创
时间:2026-11-17 00:28:35 266浏览 收藏
用 Linux io_uring 等待文件描述符事件,核心不是把它当成另一个“返回字节数”的读取接口,而是把一次 poll 请求拆成提交、完成和取消三个边界。最小方案是用 io_uring_prep_poll_add() 把 fd 与事件掩码写入 SQE,提交后从 CQE 读取 res;默认 single-shot 完成一次就结束,下一次通知要重新 arm。
如果只需要等待一次可读事件,使用 single-shot poll;如果要持续监听,选择 multishot 或在消费 CQE 后重新提交。无论哪种模式,都必须把 cqe->res 当作事件掩码或负 errno 处理,并在关闭 fd 前处理取消和最后一个 CQE。
IORING_OP_POLL_ADD负责等待 fd 的就绪状态,不负责替你读取数据。POLLIN、POLLERR、POLLHUP在 CQE 的res中返回;失败值是负 errno。- 取消按原始
user_data定位请求,-ENOENT和-EALREADY都要有明确收尾分支。
先把 poll add 设计成一次完成
liburing 的 io_uring_prep_poll_add() 只准备 SQE。它不会替应用执行 read(),所以 fd、poll_mask 和业务上下文要由应用自己保存。下面的写法把 user_data 固定成一个标识,便于 CQE 到达时认出是哪类监听。
#include#include #include #include int arm_readable_poll(struct io_uring *ring, int fd) { struct io_uring_sqe *sqe = io_uring_get_sqe(ring); if (sqe == NULL) { return -1; // SQE 用尽时先让上层决定是否等待或扩容 } // 监听可读、错误和对端挂断;poll add 默认是 single-shot。 io_uring_prep_poll_add(sqe, fd, POLLIN | POLLERR | POLLHUP); io_uring_sqe_set_data64(sqe, 0x1001); // 让 CQE 能回到这条监听上下文 int ret = io_uring_submit(ring); if (ret
生产代码还要为 io_uring_get_sqe() 失败保留退让策略。提交成功只说明请求进入 ring,不说明 fd 已经可读;真正的事件要等 CQE。single-shot CQE 消费后,若仍要监听同一 fd,就重新调用这类 arm 函数,不能假定旧请求会自动复活。

completion queue 里要区分事件和错误
拿到 struct io_uring_cqe 后,先看 res,再看 flags。对于 poll 请求,非负的 res 是就绪事件掩码;小于零则是内核返回的负 errno。它不是已经读到的字节数量,也不能直接套用普通系统调用的 errno 读取方式。
| 字段/值 | 含义 | 处理建议 |
|---|---|---|
res & POLLIN | fd 当前具备读取条件 | 再调用 read/recv,并处理短读 |
res & POLLERR 或 POLLHUP | 错误或挂断状态 | 读取业务状态,决定关闭、重连或清理 |
res | 负 errno,如取消或参数错误 | 取反后按错误码分支,不读全局 errno |
flags & IORING_CQE_F_MORE | multishot 仍可能产生后续 CQE | 保留监听上下文;没有该标志则视为终止 |
每个 CQE 都要调用 io_uring_cqe_seen() 归还给 ring。若只关心可读,也不要忽略 HUP 和 ERR:连接断开时可能同时出现可读标志,应用需要先读取剩余数据,再完成关闭决策。

持续监听选择 multishot 或重新 arm
single-shot 的优点是生命周期简单:一次 CQE 对应一次监听,处理完就重新提交。高频事件可以使用 io_uring_prep_poll_multishot(),一个 SQE 在条件再次满足时继续产生 CQE;但持续监听不等于持续有数据,应用仍要尽快消费 fd 状态,否则可能反复收到同一就绪条件。
struct io_uring_cqe *cqe = NULL;
int ret = io_uring_wait_cqe(ring, &cqe);
if (ret res;
unsigned flags = cqe->flags;
io_uring_cqe_seen(ring, cqe);
if (result >= 0 && (flags & IORING_CQE_F_MORE) == 0) {
// multishot 已终止,重新准备一个 poll 请求或进入关闭路径。
}
return result;
选择原则很直接:需要精确控制一次事件与一次业务处理的对应关系,就用 single-shot;需要一个长期存在的通知源,再考虑 multishot,并把“没有 IORING_CQE_F_MORE”当作监听结束信号。
取消 poll 时等待取消 CQE
退出、连接替换或超时关闭时,使用 io_uring_prep_poll_remove() 按原 poll 请求的 user_data 发起取消。取消请求本身也会生成 CQE,因此不能提交 remove 后立刻释放保存 fd 或上下文的内存。
struct io_uring_sqe *sqe = io_uring_get_sqe(ring);
if (sqe == NULL) {
return -1; // 没有 SQE 时先保留上下文,避免无主的活动 poll
}
// 0x1001 必须与原始 poll add 使用的 user_data 完全一致。
io_uring_prep_poll_remove(sqe, 0x1001);
io_uring_sqe_set_data64(sqe, 0x2001); // 区分“取消请求”的 CQE
return io_uring_submit(ring); // 随后继续消费 CQE,直到取消路径收敛
取消 CQE 的 res == 0 表示目标已移除;-ENOENT 通常说明目标已经先完成或标识不对,-EALREADY 则表示请求已经进入完成阶段,应用仍要等待原 poll 的最终 CQE。只有确认活动请求和它的 CQE 都不再访问上下文后,才安全关闭 fd 并释放内存。
常见问题
poll add 的 CQE res 是读取长度吗?
不是。poll 请求的非负 res 是事件掩码;真正读取多少字节,要在确认 POLLIN 后另行调用 read 或 recv。
single-shot 为什么只收到一次通知?
这是默认语义。请求完成后就从活动 poll 中移除,继续监听必须重新提交,或者改用 multishot 并检查 IORING_CQE_F_MORE。
poll remove 返回 -ENOENT 要不要重试?
通常不要盲目重试。先确认原始请求是否已经产生 CQE;若已完成,-ENOENT 表示取消目标不存在,应该进入统一清理路径,而不是重复发送取消。
-
426 收藏
-
387 收藏
-
242 收藏
-
238 收藏
-
402 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 立即学习 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 立即学习 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 立即学习 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 立即学习 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 立即学习 485次学习