rdma_rw_ctx_wrs(9)

📦 version 7.3.1, in nixpkgs unstable

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

okay so sit down because this one is genuinely so good. we're talking rdma_rw_ctx_wrs — yes, that's the function, and this page lives in the Kernel API Manual, which is giving "docs that ate" ngl. it's a little C function that hands you back a whole chain of WRs for an RDMA READ or WRITE operation, and honestly? iconic behaviour. ✨

🌸 NAME 🌸

rdma_rw_ctx_wrs — return chain of WRs for a RDMA READ or WRITE operation 🫶

✨ SYNOPSIS ✨

struct ib_send_wr * rdma_rw_ctx_wrs (struct rdma_rw_ctx *ctx , struct
ib_qp *qp , u32 port_num , struct ib_cqe *cqe , struct ib_send_wr
*chain_wr );

🎀 ARGUMENTS 🎀

  • ctx — the context to operate on 💜 this is, like, the whole vibe you're working with.
  • qp — the queue pair to operate on. yes bestie, the QP. 🦋
  • port_num — the port num to which the connection is bound 🌈
  • cqe — the completion queue entry for the last WR ⭐ remember that, it matters later.
  • chain_wr — the WR to append to the posted chain 🔥

👑 DESCRIPTION 👑

So. Here's the tea. 🍓

rdma_rw_ctx_wrs returns the WR chain for the set of RDMA READ/WRITE operations described by ctx, plus any memory registration operations that are needed. like, it's not just giving you the WRs of the operations themselves — it's also handling the memory-registration errands that go with them. no cap. 💅

important bestie moment 😭: if chain_wr is non-NULL, the WR it points to will be appended to the chain of WRs posted.

And if chain_wr is not set, then cqe must be set — otherwise the caller never gets a completion notification, and that's just not the timeline we want. 💀 So: chain_wr non-NULL → it gets appended to the posted chain. chain_wr not set → cqe must be set so the caller gets their completion notification. Both facts, both slay. 🧚

🔍 SEE ALSO 🔍

Kernel file ./drivers/infiniband/core/rw.c — go read it, it's giving main character energy 👑

aaaand that's the whole thing, bestie 🫶 this page came to us from ./drivers/infiniband/core, dated October 2026, and it's literally titled rdma_rw_ctx_wrs(9). periodt. 💖🌸✨

📦 where this page comes from