rdma_rw_ctx_signature_init(9)

📦 version 7.3.1, in nixpkgs unstable

💖 rdma_rw_ctx_signature_init(9) 💖

okay so bestie, welcome to the Kernel API Manual ✨ — this one's about setting up a RW context with signature offload, and honestly? it's giving ✨niche but powerful✨. let's get into it 🫶

🌸 NAME 🌸

rdma_rw_ctx_signature_init — initialize a RW context with signature offload 💅

🎀 SYNOPSIS 🎀

int rdma_rw_ctx_signature_init (struct rdma_rw_ctx *ctx , struct ib_qp *qp , u32 port_num , struct scatterlist *sg , u32 sg_cnt , struct scatterlist *prot_sg , u32 prot_sg_cnt , struct ib_sig_attrs *sig_attrs , u64 remote_addr , u32 rkey , enum dma_data_direction dir );

bestie look at that signature. eleven arguments. she's thriving and she knows it 👑

🦋 ARGUMENTS 🦋

so here's the whole lineup, no cap:

  • ctx — the context you're initializing. she's the main character 💖
  • qp — the queue pair you're operating on 🎀
  • port_num — the port num that this connection is bound to ✨
  • sg — the scatterlist you READ/WRITE from/to 🔥
  • sg_cnt — how many entries are in sg 🔢
  • prot_sg — the scatterlist you READ/WRITE protection information from/to 🛡️
  • prot_sg_cnt — how many entries are in prot_sg 🔢
  • sig_attrs — the signature offloading algorithms 🧚
  • remote_addr — the remote address to read/write, and lowkey this one is relative to rkey so don't forget that 🙈
  • rkey — the remote key you're operating on 🔑
  • dir — okay so this one's specific: it's DMA_TO_DEVICE for RDMA WRITE, and DMA_FROM_DEVICE for RDMA READ 💀 don't mix them up bestie

🌈 DESCRIPTION 🌈

so like, what does she actually do? if it's successful, this returns the number of WQEs that will be needed on the workqueue 🔥. and if it's not successful? she returns a negative error code 😭. that's the whole vibe. that's the tea. periodt.

💜 SEE ALSO 💜

Kernel file ./drivers/infiniband/core/rw.c, plus the whole friend group 🫶:

and that's the whole page bestie!! 🌸 this icon lives in ./drivers/infiniband/core, dated October 2026 — ily, go off, read your scatterlists responsibly 💖✨🎀

📦 where this page comes from