计算机网络 / 系统课时

SQE和CQE分别代表什么

SQE和CQE分别代表什么

理解 io_uring 时,最重要的是把“要做什么”和“做完结果是什么”分开:SQE 描述一次待提交的异步操作,CQE 描述这次操作的完成结果。掌握两者的字段与生命周期后,就能读懂一次请求从用户态提交到内核完成的完整路径。

学习目标

  • 区分 SQE 与 CQE 各自承载的信息与责任边界。
  • 理解 user_data、res 等关键字段如何关联请求与完成结果。
  • 建立 SQE 提交、内核执行、CQE 消费的生命周期视图。

SQE 描述“要做什么”

SQE 是 Submission Queue Entry,即提交队列项。应用通过 io_uring_get_sqe() 取得一个可写的 SQE,再用 io_uring_prep_read()、io_uring_prep_write() 等辅助函数填入操作类型、文件描述符、缓冲区、长度和偏移量。

SQE 的重点不是“事件已经发生”,而是“请内核执行这个操作”。常见字段包括 opcode、fd、addr、len、off 和 user_data。使用 liburing 时通常不直接手填所有字段,而是让 io_uring_prep_* 系列函数完成容易出错的布局。

CQE 描述“做成了什么”

CQE 是 Completion Queue Entry,即完成队列项。内核完成某个请求后,把结果写入 CQ。应用通过 io_uring_wait_cqe() 或 io_uring_peek_cqe() 取得 CQE,再读取 res、user_data 和 flags。

res 是最关键的完成状态:大于等于 0 时通常表示系统调用式的成功结果,例如读到的字节数;小于 0 时是负的 errno,例如 -ENOENT。这和传统系统调用“返回 -1,再读 errno”的习惯不同。

下面用一个 NOP 请求只观察 SQE 与 CQE 的关联,不引入文件 I/O 干扰:

c
#include <liburing.h>
#include <stdio.h>
#include <string.h>

int main(void) {
    struct io_uring ring;
    struct io_uring_sqe *sqe;
    struct io_uring_cqe *cqe;
    int ret;

    ret = io_uring_queue_init(8, &ring, 0);
    if (ret < 0) {
        fprintf(stderr, "queue_init: %s\n", strerror(-ret));
        return 1;
    }

    sqe = io_uring_get_sqe(&ring);
    io_uring_prep_nop(sqe);
    io_uring_sqe_set_data64(sqe, 42);

    ret = io_uring_submit(&ring);
    if (ret < 0) {
        fprintf(stderr, "submit: %s\n", strerror(-ret));
        io_uring_queue_exit(&ring);
        return 1;
    }

    ret = io_uring_wait_cqe(&ring, &cqe);
    if (ret < 0) {
        fprintf(stderr, "wait_cqe: %s\n", strerror(-ret));
        io_uring_queue_exit(&ring);
        return 1;
    }

    printf("user_data=%llu res=%d\n",
           (unsigned long long)cqe->user_data,
           cqe->res);

    io_uring_cqe_seen(&ring, cqe);
    io_uring_queue_exit(&ring);
    return 0;
}

编译并运行:

bash
cc sqe_cqe_demo.c -o sqe_cqe_demo -luring
./sqe_cqe_demo

预期输出:

text
user_data=42 res=0

如果系统不允许创建 io_uring 实例,程序会在初始化阶段报告对应错误;成功运行时,user_data=42 说明提交端写入的关联值被原样带回,res=0 表示 NOP 成功完成。

两个队列项如何连成一次操作

一次请求的核心关系可以概括为:应用先准备 SQE,提交后由内核消费;内核完成操作后生成 CQE;应用读取 CQE,并在处理完结果后调用 io_uring_cqe_seen() 推进完成队列。

SQE到CQE的一次异步操作生命周期

这两个队列项的生命周期并不对称。SQE 在提交后就不应再由应用修改,因为该槽位可能很快被重新利用;CQE 则要一直保留到应用完成读取,并显式标记为已消费。

关联请求时最容易犯的错

不要把 SQE 指针本身当成长期稳定的请求对象。更稳妥的方式是把业务上下文放在你自己的结构体里,再把其 ID 或指针编码进 user_data,收到 CQE 后据此找回上下文。

同样不要只看 io_uring_wait_cqe() 的返回值判断 I/O 是否成功。该函数返回 0 只表示“成功拿到一个 CQE”;真正的 I/O 结果在 cqe->res 中。掌握这个边界后,SQE 与 CQE 就不再是两个孤立结构,而是一对请求与完成记录。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

SQE和CQE分别代表什么

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通