当前位置:首页 > 文章列表 > 文章 > linux > Linux io_uring 怎样等待文件描述符事件

Linux io_uring 怎样等待文件描述符事件

来源:17golang原创 2026-11-17 00:28:35 0浏览 收藏

用 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删除
Linux getcap 怎样查看文件携带的 capabilitiesLinux getcap 怎样查看文件携带的 capabilities
上一篇
Linux getcap 怎样查看文件携带的 capabilities
Linux pidfd 怎样等待指定进程退出而不复用 PID
下一篇
Linux pidfd 怎样等待指定进程退出而不复用 PID
查看更多
最新文章
查看更多
课程推荐
  • 前端进阶之JavaScript设计模式
    前端进阶之JavaScript设计模式
    设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
    543次学习
  • GO语言核心编程课程
    GO语言核心编程课程
    本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
    516次学习
  • 简单聊聊mysql8与网络通信
    简单聊聊mysql8与网络通信
    如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
    500次学习
  • JavaScript正则表达式基础与实战
    JavaScript正则表达式基础与实战
    在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
    487次学习
  • 从零制作响应式网站—Grid布局
    从零制作响应式网站—Grid布局
    本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
    485次学习
查看更多
AI推荐
  • PubMedQA数据集详解:生物医学问答基准、功能与应用指南
    PubMedQA
    深入了解PubMedQA生物医学问答数据集,涵盖其核心功能、使用方法及在临床决策、药物研发等场景的应用,助力提升NLP模型性能。
    1057次使用
  • H2O EvalGPT:开源LLM大模型评估与排行榜工具
    H2O EvalGPT
    H2O EvalGPT是H2O.ai推出的开源LLM评估平台,提供详细的大模型性能排行榜、行业特定基准测试及A/B测试功能,助您快速选择最适合项目的高性能大语言模型。
    1058次使用
  • LMArena是什么?伯克利AI模型评估平台使用指南与功能解析
    LMArena
    LMArena是加州大学伯克利分校推出的AI模型匿名评测平台。通过盲测投票机制,用户可对比不同大模型回答并生成实时排行榜,助力开发者优化模型及用户选择最佳AI工具。
    1222次使用
  • 斯坦福HELM:大语言模型Holistic Evaluation整体评估框架详解
    HELM
    深入了解斯坦福推出的HELM(Holistic Evaluation of Language Models)大模型评测体系。本文解析其核心功能、安装配置步骤及应用场景,涵盖准确性、公平性、鲁棒性等多维度指标,助力开发者全面优化语言模型性能。
    1164次使用
  • MMBench详解:多模态大模型基准测试、功能特点与使用指南
    MMBench
    MMBench是由上海人工智能实验室等机构联合推出的多模态基准测试平台,提供细粒度能力评估、大规模数据集及VLMEvalKit工具。本文详细介绍其核心功能、安装使用方法及应用场景,助力开发者全面评估多模态模型性能。
    1005次使用
微信登录更方便
  • 密码登录
  • 注册账号
登录即同意 用户协议 和 隐私政策
返回登录
  • 重置密码