登录
推荐 文章 Go 技术 课程 下载 专题 AI
首页 >  文章 >  linux

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 函数,不能假定旧请求会自动复活。

Linux io_uring poll add 中应用任务、SQE、文件描述符事件掩码与 completion queue 的静态关系说明图
图1:io_uring poll add 的静态关系说明图,展示 SQE、文件描述符和 CQE 的契约,不是截图或运行证据。

completion queue 里要区分事件和错误

拿到 struct io_uring_cqe 后,先看 res,再看 flags。对于 poll 请求,非负的 res 是就绪事件掩码;小于零则是内核返回的负 errno。它不是已经读到的字节数量,也不能直接套用普通系统调用的 errno 读取方式。

字段/值含义处理建议
res & POLLINfd 当前具备读取条件再调用 read/recv,并处理短读
res & POLLERR 或 POLLHUP错误或挂断状态读取业务状态,决定关闭、重连或清理
res 负 errno,如取消或参数错误取反后按错误码分支,不读全局 errno
flags & IORING_CQE_F_MOREmultishot 仍可能产生后续 CQE保留监听上下文;没有该标志则视为终止

每个 CQE 都要调用 io_uring_cqe_seen() 归还给 ring。若只关心可读,也不要忽略 HUP 和 ERR:连接断开时可能同时出现可读标志,应用需要先读取剩余数据,再完成关闭决策。

Linux io_uring CQE 的 res 事件掩码、负 errno、flags 和用户态处理边界结构图
图2:CQE 结果分层结构图,区分事件掩码、负 errno 和持续通知标记,不代表某次真实运行输出。

持续监听选择 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 表示取消目标不存在,应该进入统一清理路径,而不是重复发送取消。

声明:本文转载于:17golang原创 如有侵犯,请联系study_golang@163.com删除
相关阅读
更多>
最新阅读
更多>
课程推荐
更多>