From: Joanne Koong <joannelkoong@gmail.com>
To: miklos@szeredi.hu, axboe@kernel.dk
Cc: bschubert@ddn.com, asml.silence@gmail.com,
io-uring@vger.kernel.org, csander@purestorage.com,
xiaobing.li@samsung.com, linux-fsdevel@vger.kernel.org
Subject: [PATCH v3 01/25] io_uring/kbuf: refactor io_buf_pbuf_register() logic into generic helpers
Date: Mon, 22 Dec 2025 16:34:58 -0800 [thread overview]
Message-ID: <20251223003522.3055912-2-joannelkoong@gmail.com> (raw)
In-Reply-To: <20251223003522.3055912-1-joannelkoong@gmail.com>
Refactor the logic in io_register_pbuf_ring() into generic helpers:
- io_validate_buf_reg(): Validate user input and buffer registration
parameters
- io_alloc_new_buffer_list(): Allocate and initialize a new buffer
list for the given buffer group ID
- io_setup_pbuf_ring(): Sets up the physical buffer ring region and
handles memory mapping for provided buffer rings
This is a preparatory change for upcoming kernel-managed buffer ring
support which will need to reuse some of these helpers.
Signed-off-by: Joanne Koong <joannelkoong@gmail.com>
---
io_uring/kbuf.c | 123 ++++++++++++++++++++++++++++++++----------------
1 file changed, 82 insertions(+), 41 deletions(-)
diff --git a/io_uring/kbuf.c b/io_uring/kbuf.c
index 796d131107dd..100367bb510b 100644
--- a/io_uring/kbuf.c
+++ b/io_uring/kbuf.c
@@ -596,55 +596,71 @@ int io_manage_buffers_legacy(struct io_kiocb *req, unsigned int issue_flags)
return IOU_COMPLETE;
}
-int io_register_pbuf_ring(struct io_ring_ctx *ctx, void __user *arg)
+static int io_validate_buf_reg(struct io_uring_buf_reg *reg,
+ unsigned int permitted_flags)
{
- struct io_uring_buf_reg reg;
- struct io_buffer_list *bl;
- struct io_uring_region_desc rd;
- struct io_uring_buf_ring *br;
- unsigned long mmap_offset;
- unsigned long ring_size;
- int ret;
-
- lockdep_assert_held(&ctx->uring_lock);
-
- if (copy_from_user(®, arg, sizeof(reg)))
- return -EFAULT;
- if (!mem_is_zero(reg.resv, sizeof(reg.resv)))
+ if (!mem_is_zero(reg->resv, sizeof(reg->resv)))
return -EINVAL;
- if (reg.flags & ~(IOU_PBUF_RING_MMAP | IOU_PBUF_RING_INC))
+ if (reg->flags & ~permitted_flags)
return -EINVAL;
- if (!is_power_of_2(reg.ring_entries))
+ if (!is_power_of_2(reg->ring_entries))
return -EINVAL;
/* cannot disambiguate full vs empty due to head/tail size */
- if (reg.ring_entries >= 65536)
+ if (reg->ring_entries >= 65536)
return -EINVAL;
+ return 0;
+}
- bl = io_buffer_get_list(ctx, reg.bgid);
- if (bl) {
+static int io_alloc_new_buffer_list(struct io_ring_ctx *ctx,
+ struct io_uring_buf_reg *reg,
+ struct io_buffer_list **bl)
+{
+ struct io_buffer_list *list;
+
+ list = io_buffer_get_list(ctx, reg->bgid);
+ if (list) {
/* if mapped buffer ring OR classic exists, don't allow */
- if (bl->flags & IOBL_BUF_RING || !list_empty(&bl->buf_list))
+ if (list->flags & IOBL_BUF_RING || !list_empty(&list->buf_list))
return -EEXIST;
- io_destroy_bl(ctx, bl);
+ io_destroy_bl(ctx, list);
}
- bl = kzalloc(sizeof(*bl), GFP_KERNEL_ACCOUNT);
- if (!bl)
+ list = kzalloc(sizeof(*list), GFP_KERNEL_ACCOUNT);
+ if (!list)
return -ENOMEM;
- mmap_offset = (unsigned long)reg.bgid << IORING_OFF_PBUF_SHIFT;
- ring_size = flex_array_size(br, bufs, reg.ring_entries);
+ list->nr_entries = reg->ring_entries;
+ list->mask = reg->ring_entries - 1;
+ list->flags = IOBL_BUF_RING;
+
+ *bl = list;
+
+ return 0;
+}
+
+static int io_setup_pbuf_ring(struct io_ring_ctx *ctx,
+ struct io_uring_buf_reg *reg,
+ struct io_buffer_list *bl)
+{
+ struct io_uring_region_desc rd;
+ unsigned long mmap_offset;
+ unsigned long ring_size;
+ int ret;
+
+ mmap_offset = (unsigned long)reg->bgid << IORING_OFF_PBUF_SHIFT;
+ ring_size = flex_array_size(bl->buf_ring, bufs, reg->ring_entries);
memset(&rd, 0, sizeof(rd));
rd.size = PAGE_ALIGN(ring_size);
- if (!(reg.flags & IOU_PBUF_RING_MMAP)) {
- rd.user_addr = reg.ring_addr;
+ if (!(reg->flags & IOU_PBUF_RING_MMAP)) {
+ rd.user_addr = reg->ring_addr;
rd.flags |= IORING_MEM_REGION_TYPE_USER;
}
+
ret = io_create_region(ctx, &bl->region, &rd, mmap_offset);
if (ret)
- goto fail;
- br = io_region_get_ptr(&bl->region);
+ return ret;
+ bl->buf_ring = io_region_get_ptr(&bl->region);
#ifdef SHM_COLOUR
/*
@@ -656,25 +672,50 @@ int io_register_pbuf_ring(struct io_ring_ctx *ctx, void __user *arg)
* should use IOU_PBUF_RING_MMAP instead, and liburing will handle
* this transparently.
*/
- if (!(reg.flags & IOU_PBUF_RING_MMAP) &&
- ((reg.ring_addr | (unsigned long)br) & (SHM_COLOUR - 1))) {
- ret = -EINVAL;
- goto fail;
+ if (!(reg->flags & IOU_PBUF_RING_MMAP) &&
+ ((reg->ring_addr | (unsigned long)bl->buf_ring) &
+ (SHM_COLOUR - 1))) {
+ io_free_region(ctx->user, &bl->region);
+ return -EINVAL;
}
#endif
- bl->nr_entries = reg.ring_entries;
- bl->mask = reg.ring_entries - 1;
- bl->flags |= IOBL_BUF_RING;
- bl->buf_ring = br;
+ return 0;
+}
+
+int io_register_pbuf_ring(struct io_ring_ctx *ctx, void __user *arg)
+{
+ unsigned int permitted_flags;
+ struct io_uring_buf_reg reg;
+ struct io_buffer_list *bl;
+ int ret;
+
+ lockdep_assert_held(&ctx->uring_lock);
+
+ if (copy_from_user(®, arg, sizeof(reg)))
+ return -EFAULT;
+
+ permitted_flags = IOU_PBUF_RING_MMAP | IOU_PBUF_RING_INC;
+ ret = io_validate_buf_reg(®, permitted_flags);
+ if (ret)
+ return ret;
+
+ ret = io_alloc_new_buffer_list(ctx, ®, &bl);
+ if (ret)
+ return ret;
+
+ ret = io_setup_pbuf_ring(ctx, ®, bl);
+ if (ret) {
+ kfree(bl);
+ return ret;
+ }
+
if (reg.flags & IOU_PBUF_RING_INC)
bl->flags |= IOBL_INC;
+
io_buffer_add_list(ctx, bl, reg.bgid);
+
return 0;
-fail:
- io_free_region(ctx->user, &bl->region);
- kfree(bl);
- return ret;
}
int io_unregister_pbuf_ring(struct io_ring_ctx *ctx, void __user *arg)
--
2.47.3
next prev parent reply other threads:[~2025-12-23 0:36 UTC|newest]
Thread overview: 26+ messages / expand[flat|nested] mbox.gz Atom feed top
2025-12-23 0:34 [PATCH v3 00/25] fuse/io-uring: add kernel-managed buffer rings and zero-copy Joanne Koong
2025-12-23 0:34 ` Joanne Koong [this message]
2025-12-23 0:34 ` [PATCH v3 02/25] io_uring/kbuf: rename io_unregister_pbuf_ring() to io_unregister_buf_ring() Joanne Koong
2025-12-23 0:35 ` [PATCH v3 03/25] io_uring/kbuf: add support for kernel-managed buffer rings Joanne Koong
2025-12-23 0:35 ` [PATCH v3 04/25] io_uring/kbuf: add mmap " Joanne Koong
2025-12-23 0:35 ` [PATCH v3 05/25] io_uring/kbuf: support kernel-managed buffer rings in buffer selection Joanne Koong
2025-12-23 0:35 ` [PATCH v3 06/25] io_uring/kbuf: add buffer ring pinning/unpinning Joanne Koong
2025-12-23 0:35 ` [PATCH v3 07/25] io_uring/kbuf: add recycling for kernel managed buffer rings Joanne Koong
2025-12-23 0:35 ` [PATCH v3 08/25] io_uring: add io_uring_cmd_fixed_index_get() and io_uring_cmd_fixed_index_put() Joanne Koong
2025-12-23 0:35 ` [PATCH v3 09/25] io_uring/kbuf: add io_uring_cmd_is_kmbuf_ring() Joanne Koong
2025-12-23 0:35 ` [PATCH v3 10/25] io_uring/kbuf: export io_ring_buffer_select() Joanne Koong
2025-12-23 0:35 ` [PATCH v3 11/25] io_uring/kbuf: return buffer id in buffer selection Joanne Koong
2025-12-23 0:35 ` [PATCH v3 12/25] io_uring/cmd: set selected buffer index in __io_uring_cmd_done() Joanne Koong
2025-12-23 0:35 ` [PATCH v3 13/25] fuse: refactor io-uring logic for getting next fuse request Joanne Koong
2025-12-23 0:35 ` [PATCH v3 14/25] fuse: refactor io-uring header copying to ring Joanne Koong
2025-12-23 0:35 ` [PATCH v3 15/25] fuse: refactor io-uring header copying from ring Joanne Koong
2025-12-23 0:35 ` [PATCH v3 16/25] fuse: use enum types for header copying Joanne Koong
2025-12-23 0:35 ` [PATCH v3 17/25] fuse: refactor setting up copy state for payload copying Joanne Koong
2025-12-23 0:35 ` [PATCH v3 18/25] fuse: support buffer copying for kernel addresses Joanne Koong
2025-12-23 0:35 ` [PATCH v3 19/25] fuse: add io-uring kernel-managed buffer ring Joanne Koong
2025-12-23 0:35 ` [PATCH v3 20/25] io_uring/rsrc: rename io_buffer_register_bvec()/io_buffer_unregister_bvec() Joanne Koong
2025-12-23 0:35 ` [PATCH v3 21/25] io_uring/rsrc: split io_buffer_register_request() logic Joanne Koong
2025-12-23 0:35 ` [PATCH v3 22/25] io_uring/rsrc: Allow buffer release callback to be optional Joanne Koong
2025-12-23 0:35 ` [PATCH v3 23/25] io_uring/rsrc: add io_buffer_register_bvec() Joanne Koong
2025-12-23 0:35 ` [PATCH v3 24/25] fuse: add zero-copy over io-uring Joanne Koong
2025-12-23 0:35 ` [PATCH v3 25/25] docs: fuse: add io-uring bufring and zero-copy documentation Joanne Koong
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20251223003522.3055912-2-joannelkoong@gmail.com \
--to=joannelkoong@gmail.com \
--cc=asml.silence@gmail.com \
--cc=axboe@kernel.dk \
--cc=bschubert@ddn.com \
--cc=csander@purestorage.com \
--cc=io-uring@vger.kernel.org \
--cc=linux-fsdevel@vger.kernel.org \
--cc=miklos@szeredi.hu \
--cc=xiaobing.li@samsung.com \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox