io_uring_free_reg_wait(3)

💖 io_uring_free_reg_wait — frees a previously registered wait region 💖

okay bestie, so you know how we're hanging out in the liburing manual? yeah. this page lives there. it's a lil three-parter and it's lowkey iconic, let's get into it 🫶

✨ SYNOPSIS ✨

#include <liburing.h>

void io_uring_free_reg_wait(struct io_uring *ring,
                            unsigned nentries);

🌸 DESCRIPTION 🌸

so io_uring_free_reg_wait(3) does exactly one thing and it does it slay: it frees a wait region for the ring ring of nentries that you previously set up with io_uring_setup_reg_wait(3). that's it. that's the whole vibe. 🎀

but here's the tea, and it's important, so listen up bestie 👑

registered wait regions persist for the life time of the ring. so on the kernel side? those wait regions are still there, still active, still doing their thing. in fact, your application may still use them for wait operations. the only thing that changes is that the application can no longer modify them. that's the whole switch. not deleted, not gone, just ✨ locked for editing ✨.

no cap, this is a "you can look but you can't touch" situation, not a "it's gone forever" situation. don't get it twisted 💅

Available since kernel 6.13. 🌈

👀 SEE ALSO 👀

• io_uring_submit_and_wait_reg(3)
• io_uring_free_reg_wait(3)

(yes it references itself. main character energy fr fr. iykyk 💀)

okay that's the page!! this was liburing-2.9, dated November 2, 2024 — mwah, thanks for reading, go free some wait regions responsibly 🦋💜