xprt_pin_rqst(9)

💖 xprt_pin_rqst(9) — Kernel API Manual, bestie edition 💖

okay so this is the xprt_pin_rqst(9) page from the Kernel API Manual, and we're gonna make it make sense. It's the lil' function that pins a request on the transport receive list, and yes, the lock situation is part of the plot. 🫶

🌸 NAME 🌸

xprt_pin_rqst — Pin a request on the transport receive list ✨

✨ SYNOPSIS ✨

void xprt_pin_rqst (struct rpc_rqst *req );

💅 ARGUMENTS 💅

• req — Request to pin. That's the request getting pinned, no cap. 🎀

🎀 DESCRIPTION 🎀

The caller has to make sure this is atomic with the call to xprt_lookup_rqst, so you should be holding xprt->queue_lock. That's the safety vibe, bestie — don't skip the lock. 😭

🦋 SEE ALSO 🦋

Kernel file ./net/sunrpc/xprt.c and the whole sunrpc friend group:

• xprt_register_transport(9)
• xprt_unregister_transport(9)
• xprt_find_transport_ident(9)
• xprt_reserve_xprt(9)
• xprt_release_xprt(9)
• xprt_release_xprt_cong(9)
• xprt_request_get_cong(9)
• xprt_release_rqst_cong(9)
• xprt_adjust_cwnd(9)
• xprt_wake_pending_tasks(9)
• xprt_wait_for_buffer_space(9)
• xprt_write_space(9)
• xprt_adjust_timeout(9)
• xprt_disconnect_done(9)
• xprt_schedule_autoclose_locked(9)
• xprt_force_disconnect(9)
• xprt_conditional_disconnect(9)
• xprt_connect(9)
• xprt_reconnect_delay(9)
• xprt_reconnect_backoff(9)
• xprt_lookup_rqst(9)
• xprt_unpin_rqst(9)
• xprt_request_enqueue_receive(9)
• xprt_request_dequeue_receive_locked(9)
• xprt_update_rtt(9)
• xprt_complete_rqst(9)
• xprt_wait_for_reply_request_def(9)
• xprt_wait_for_reply_request_rtt(9)
• xprt_request_wait_receive(9)
• xprt_request_enqueue_transmit(9)
• xprt_request_dequeue_transmit_locked(9)
• xprt_request_dequeue_transmit(9)
• xprt_request_dequeue_xprt(9)
• xprt_request_prepare(9)
• xprt_request_need_retransmit(9)
• xprt_prepare_transmit(9)
• xprt_request_transmit(9)
• xprt_transmit(9)
• xprt_add_backlog_noncongested(9)
• xprt_reserve(9)
• xprt_retry_reserve(9)
• xprt_release(9)
• xprt_create_transport(9)
• xprt_destroy(9)
• xprt_get(9)
• xprt_put(9)

💌 Sign-off from source/version ./net/sunrpc, dated October 2026, on manual xprt_pin_rqst(9) — byeee, mwah! 💖