rpc_switch_client_transport(9)

💅 rpc_switch_client_transport(9) 💅

okay bestie, welcome to the Kernel API Manual corner where we talk about rpc_switch_client_transport — the glow-up button for an RPC transport. No cap, this one is lowkey iconic when you're out here juggling mirrored NFS servers. ✨

🎀 NAME 🎀

rpc_switch_client_transport — switch the RPC transport on the fly. 🦋

✨ SYNOPSIS ✨

int rpc_switch_client_transport (struct rpc_clnt *clnt , struct
       xprt_create *args , const struct rpc_timeout *timeout );

💖 ARGUMENTS 💖

• clnt — pointer to a struct rpc_clnt. This is the main-character client struct getting its transport swapped. 👑
• args — pointer to the new transport arguments. Fresh xprt setup goes here. 🧚
• timeout — pointer to the new timeout parameters. The new timing vibe. ⏰

🌈 DESCRIPTION 🌈

So the tea is: this function lets the caller switch the RPC transport for the rpc_clnt structure 'clnt' so it can connect to a mirrored NFS server, for instance. 💫

It assumes that the caller has ensured that there are no active RPC tasks by using some form of locking. Like, do the locking first, bestie — this function is not out here doing your task cleanup for you. 🔒

Returns zero if "clnt" is now using the new xprt. Slay. ✅ Otherwise a negative errno is returned, and "clnt" continues to use the old xprt. So if it doesn't work, no dramatic transport change — it stays with its old xprt. 💀

🔥 SEE ALSO 🔥

Kernel file ./net/sunrpc/clnt.c:

• rpc_create(9)
• rpc_clone_client(9)
• rpc_clone_client_set_auth(9)
• rpc_clnt_iterate_for_each_xprt(9)
• rpc_cancel_tasks(9)
• rpc_hold_client(9)
• rpc_release_client(9)
• rpc_bind_new_program(9)
• rpc_run_task(9)
• rpc_call_sync(9)
• rpc_call_async(9)
• rpc_run_bc_task(9)
• rpc_prepare_reply_pages(9)
• rpc_peeraddr(9)
• rpc_peeraddr2str(9)
• rpc_localaddr(9)
• rpc_net_ns(9)
• rpc_max_payload(9)
• rpc_max_bc_payload(9)
• rpc_force_rebind(9)
• rpc_clnt_test_and_add_xprt(9)
• rpc_clnt_setup_test_and_add_xprt(9)
• rpc_clnt_add_xprt(9)

xoxo, your ./net/sunrpc source, October 2026 vibes, and the one and only rpc_switch_client_transport(9) 💅✨