]> git.ipfire.org Git - thirdparty/kernel/linux.git/commitdiff
io_uring/query: introduce rings info query
authorPavel Begunkov <asml.silence@gmail.com>
Thu, 13 Nov 2025 10:48:58 +0000 (10:48 +0000)
committerJens Axboe <axboe@kernel.dk>
Thu, 13 Nov 2025 18:17:36 +0000 (11:17 -0700)
Same problem as with zcrx in the previous patch, the user needs to know
SQ/CQ header sizes to allocated memory before setup to use it for user
provided rings, i.e. IORING_SETUP_NO_MMAP, however that information is
only returned after registration, hence the user is guessing kernel
implementation details.

Return the header size and alignment, which is split with the same
motivation, to allow the user to know the real structure size without
alignment in case there will be more flexible placement schemes in the
future.

Signed-off-by: Pavel Begunkov <asml.silence@gmail.com>
Signed-off-by: Jens Axboe <axboe@kernel.dk>
include/uapi/linux/io_uring/query.h
io_uring/query.c

index fc0cb1580e47370aea6a4c463f7becff41502cf6..2456e6c5ebb5e02848acf6cce41dfc343859c572 100644 (file)
@@ -19,6 +19,7 @@ struct io_uring_query_hdr {
 enum {
        IO_URING_QUERY_OPCODES                  = 0,
        IO_URING_QUERY_ZCRX                     = 1,
+       IO_URING_QUERY_SCQ                      = 2,
 
        __IO_URING_QUERY_MAX,
 };
@@ -57,4 +58,11 @@ struct io_uring_query_zcrx {
        __u64 __resv2;
 };
 
+struct io_uring_query_scq {
+       /* The SQ/CQ rings header size */
+       __u64 hdr_size;
+       /* The alignment for the header */
+       __u64 hdr_alignment;
+};
+
 #endif
index 6f9fa5153903f8552a02502040a5b26e92bc5375..e61b6221f87f27445239430a33e57cd6904b5d15 100644 (file)
@@ -9,6 +9,7 @@
 union io_query_data {
        struct io_uring_query_opcode opcodes;
        struct io_uring_query_zcrx zcrx;
+       struct io_uring_query_scq scq;
 };
 
 #define IO_MAX_QUERY_SIZE              sizeof(union io_query_data)
@@ -43,6 +44,15 @@ static ssize_t io_query_zcrx(union io_query_data *data)
        return sizeof(*e);
 }
 
+static ssize_t io_query_scq(union io_query_data *data)
+{
+       struct io_uring_query_scq *e = &data->scq;
+
+       e->hdr_size = sizeof(struct io_rings);
+       e->hdr_alignment = SMP_CACHE_BYTES;
+       return sizeof(*e);
+}
+
 static int io_handle_query_entry(struct io_ring_ctx *ctx,
                                 union io_query_data *data, void __user *uhdr,
                                 u64 *next_entry)
@@ -74,6 +84,9 @@ static int io_handle_query_entry(struct io_ring_ctx *ctx,
        case IO_URING_QUERY_ZCRX:
                ret = io_query_zcrx(data);
                break;
+       case IO_URING_QUERY_SCQ:
+               ret = io_query_scq(data);
+               break;
        }
 
        if (ret >= 0) {