rpc_clnt_set...and_add_xprt(9)

🌸 NAME 🌸

Bestie, you're on the rpc_clnt_set...and_add_xprt(9) page in the Kernel API Manual, and the function we're hyping up is:

rpc_clnt_setup_test_and_add_xprt -

That's the whole NAME entry — just the function name and a dash, no extra description, and honestly? iconic minimalism 💅.

✨ SYNOPSIS ✨

int rpc_clnt_setup_test_and_add_xprt (struct rpc_clnt *clnt , struct
       rpc_xprt_switch *xps , struct rpc_xprt *xprt , void *data );

🎀 ARGUMENTS 🎀

Here's the cast, bestie:

• clnt — the struct rpc_clnt that's getting the new transport 🫶
• xps — the rpc_xprt_switch that's holding the new transport ✨
• xprt — the rpc_xprt to test 🔍
• data — a struct rpc_add_xprt_test pointer that holds the test function and test function call data 💖

💅 DESCRIPTION 💅

Okay so this is an rpc_clnt_add_xprt setup function, and it returns 1, so:

1. The caller of the test function must dereference the rpc_xprt_switch and the rpc_xprt.
2. The test function must call rpc_xprt_switch_add_xprt, usually in the rpc_call_done routine.

Upon success (return of 1), the test function adds the new transport to the rpc_clnt xprt switch. Slay ✨

🦋 SEE ALSO 🦋

The kernel file in the mix is ./net/sunrpc/clnt.c, and these are the SEE ALSO besties:

• rpc_create(9)
• rpc_clone_client(9)
• rpc_clone_client_set_auth(9)
• rpc_switch_client_transport(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_add_xprt(9)

mwah 💋 that's a wrap! This one comes from ./net/sunrpc, dated October 2026, and it's the rpc_clnt_set...and_add_xprt(9) page. Bye bestie, go be iconic 🫶✨