__nfs_pageio_add_request(9)

💅 __nfs_pageio_add_request (9) — from the Kernel API Manual, bestie 🎀

okay so picture this: you're deep in the kernel, you've got a request, you've got a page list, and you want them to merge into one glorious little page group. that's this function. it's giving matchmaker energy fr fr 💖

---

✨ SYNOPSIS ✨

int __nfs_pageio_add_request (struct nfs_pageio_descriptor *desc ,
       struct nfs_page *req );

yes that's a leading double underscore, no she did NOT come to play 🫶

---

🌸 ARGUMENTS 🌸

• desc — the destination io descriptor. this is the page list she's trying to slide into 💅
• req — the request itself, the main character of this whole operation ⭐

---

🦋 DESCRIPTION 🦋

so here's the tea: this may split a request into subrequests, and all of those subrequests are part of the same page group. no cap. 🧚

and if it does split? it will submit req as the last one — and that's on purpose, okay, it's not a vibe, it's a safety thing: that way the pointer to req is still valid in case of failure. protecting the pointer's whole life out here 😭💀

it returns true if the request req was successfully coalesced into the existing list of pages desc. so like… true = slay, they merged. 🌈

---

👑 SEE ALSO 👑

kernel file ./fs/nfs/pagelist.c — and the whole friend group:

• nfs_iocounter_wait(9)
• nfs_async_iocounter_wait(9)
• nfs_page_group_sync_on_bit_locked(9)
• nfs_page_create_from_page(9)
• nfs_page_create_from_folio(9)
• nfs_unlock_request(9)
• nfs_unlock_and_release_request(9)
• nfs_free_request(9)
• nfs_pgio_data_destroy(9)
• nfs_pgio_rpcsetup(9)
• nfs_pgio_prepare(9)
• nfs_pgio_error(9)
• nfs_pgio_release(9)
• nfs_pageio_init(9)
• nfs_pgio_result(9)
• nfs_coalesce_size(9)
• nfs_pageio_do_add_request(9)
• nfs_pageio_complete(9)
• nfs_pageio_cond_complete(9)

like… the whole squad showed up. iykyk 💜

---

mwah 💋 this lil page lives in ./fs/nfs and it's stamped October 2026 — catch you in the next one, bestie! 🍓✨