xprt_switch_alloc(9)

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

okay so real talk, this is a page straight out of the Kernel API Manual, and it's about xprt_switch_alloc. it's short, it's sweet, it's giving lowkey iconic. let's go ✨

---

✨ NAME ✨

xprt_switch_alloc — allocate a new struct rpc_xprt_switch 🎀

---

🦋 SYNOPSIS 🦋

struct rpc_xprt_switch * xprt_switch_alloc (struct rpc_xprt *xprt ,
       gfp_t gfp_flags );

that's the whole signature, no cap. two args, one pointer back. slay 💅

---

🌸 ARGUMENTS 🌸

• xprt — a pointer to struct rpc_xprt. that's the transport you're handing over, bestie, so it can live inside the new switch 🫶
• gfp_flags — the allocation flags. yep, the usual gfp_t situation, you know what to do ✨

---

🔥 DESCRIPTION 🔥

so here's the vibe check: on success, this hands you back an initialised struct rpc_xprt_switch, and that switch is already holding the entry xprt — the one you passed in. it's giving "move-in ready" 🏠✨

and if it doesn't work out? returns NULL on failure. no drama, just NULL. 😭💀

ngl, please actually check for that NULL, bestie. the page says failure returns NULL, and that's the whole story 🙈

---

👑 SEE ALSO 👑

kernel file ./net/sunrpc/xprtmultipath.c — and honestly the whole friend group:

• rpc_xprt_switch_add_xprt(9)
• rpc_xprt_switch_remove_xprt(9)
• rpc_xprt_switch_get_main_xprt(9)
• xprt_switch_get(9)
• xprt_switch_put(9)
• rpc_xprt_switch_set_roundrobin(9)
• xprt_iter_init(9)
• xprt_iter_init_listall(9)
• xprt_iter_xchg_switch(9)
• xprt_iter_destroy(9)
• xprt_iter_xprt(9)
• xprt_iter_get_next(9)

---

⭐ okay that's the whole page, mwah 💋 — big love from ./net/sunrpc, dated October 2026, and this one's called xprt_switch_alloc(9) in case you forgot already 🎀✨