xprt_rdma_allocate(9)

💅 xprt_rdma_allocate ✨

okay so bestie, this is a page from the Kernel API Manual — yes, the kernel, we're doing kernel stuff today, hydrate first 🫶 — and it's all about xprt_rdma_allocate, the little function that goes and gets the transport resources ready for an RPC. Very behind-the-scenes, very main character energy. 🌸

---

✨ NAME ✨

xprt_rdma_allocate — allocate transport resources for an RPC 😤💪

---

🎀 SYNOPSIS 🎀

int xprt_rdma_allocate (struct rpc_task *task );

---

🦋 ARGUMENTS 🦋

• task — the RPC task. that's it, that's the whole argument. she's low maintenance 💅

---

🌈 DESCRIPTION 🌈

So what actually happens? honestly it's giving "go fetch the resources, queen". and then it tells you how it went, via the return values — pay attention, this part matters fr fr:

• 0 — Success! 🎉 and rq_buffer points to the RPC buffer to use. iconic. go use it.
• ENOMEM — Out of memory 😭 bestie the memory is gone. call again later, ok?
• EIO — A permanent error occurred. 🚩 not a vibe. do not retry — like, genuinely, don't, it's permanent, it's not gonna suddenly start working. periodt.

fair warning 💀: EIO means permanent. if you retry anyway that's on you and the kernel will simply Not be helpful about it.

---

💜 SEE ALSO 💜

the whole squad 🫶 — check these out:

• Kernel file ./net/sunrpc/xprtrdma/transport.c — the actual source, go peek 👀
• xprt_rdma_connect_worker(9)
• xprt_rdma_inject_disconnect(9)
• xprt_rdma_destroy(9)
• xprt_setup_rdma(9)
• xprt_rdma_close(9)
• xprt_rdma_set_port(9)
• xprt_rdma_timer(9)
• xprt_rdma_set_connect_timeout(9)
• xprt_rdma_connect(9)
• xprt_rdma_alloc_slot(9)
• xprt_rdma_free_slot(9)
• xprt_rdma_free(9)
• xprt_rdma_send_request(9)

---

and that's the whole page, bestie, you ate that 🍓✨ this cutie lives over in ./net/sunrpc/xprtrdma, dated October 2026, and it's part of the Kernel API Manual — so go forth and allocate responsibly 💖🧚‍♀️