VFS_IO_URING(8)

💖 vfs_io_uring(8) — the manual page, but make it slay 💖

okay bestie, sit down, hydrate, because we're talking about vfs_io_uring(8) — a Samba system administration tool and honestly? she's iconic for it.

---

✨ NAME ✨

vfs_io_uring — bestie, this is the thing that implements async io in Samba vfs using io_uring of Linux (>= 5.1). no cap.

---

🌸 SYNOPSIS 🌸

vfs objects = io_uring

that's it. that's the whole vibe. 💅

---

🦋 DESCRIPTION 🦋

This VFS module is part of the samba(7) suite. she runs with the big girls.

The io_uring VFS module enables asynchronous pread, pwrite and fsync using the io_uring infrastructure of Linux (>= 5.1). and the way that it does this? it provides much less overhead compared to the usage of the pthreadpool for async io. lowkey a glow-up. 🔥

⚠️ IMPORTANT SIS: this module SHOULD be listed last in any module stack, because it requires real kernel file descriptors. like, real ones. you cannot fake it. put her at the end of the lineup, she's the finale. 👑

---

🎀 EXAMPLES 🎀

straight forward use, no drama, just vibes:

[cooldata]
path = /data/ice
vfs objects = io_uring

see how io_uring is chilling at the end? that's the assignment. ✅

---

💅 OPTIONS 💅

• io_uring:num_entries = NUMBER_OF_QUEUE_ENTRIES — this one sets the number of entries in the submission queue. the maximum allowed value depends on the kernel version, and the kernel will roundup the value to a power of 2. so don't come at her with your little arbitrary numbers, she's doing math on you. 🙈 The default is '128'.
• io_uring:sqpoll = BOOL — use the IORING_SETUP_SQPOLL feature. dir. The default is 'no'.

---

🌈 SEE ALSO 🌈

• io_uring_setup(2)

go read her too, she's the blueprint. iykyk. 🫶

---

⭐ VERSION ⭐

This man page is part of version 4.24.7-Ubuntu-4.24.7+dfsg-1ubuntu1 of the Samba suite.

---

👑 AUTHOR 👑

The original Samba software and related utilities were created by Andrew Tridgell. Samba is now developed by the Samba Team as an Open Source project similar to the way the Linux kernel is developed. periodt. 💜

---

and that's the whole page bestie — vfs_io_uring(8), from Samba 4.24.7-Ubuntu-4.24.7+dfs, dated 09/13/2026, VFS_IO_URING(8). go forth and async your io, you absolute main character. 🧚✨🍓