rtrs_clt_request(9)

📦 version 7.3.1, in nixpkgs unstable

💜 rtrs_clt_request(9) 💜

okay bestie, welcome to the Kernel API Manual ✨ you're literally about to read the page for rtrs_clt_request — the one that asks for a data transfer to/from the server via RDMA. iykyk 🫶

✨ NAME ✨

rtrs_clt_request — request data transfer to/from server via RDMA 💅

🎀 SYNOPSIS 🎀

int rtrs_clt_request (int dir , struct rtrs_clt_req_ops *ops , struct
rtrs_clt_sess *clt , struct rtrs_permit *permit , const struct kvec *vec
, size_t nr , size_t data_len , struct scatterlist *sg , unsigned int
sg_cnt );

🦋 ARGUMENTS 🦋

  • dir — READ/WRITE. pick your vibe, no in-between 🌀
  • ops — the callback function to be called as confirmation, and the pointer. so like, who do we ping when it's done, and with what 🌸
  • clt — Session. the whole connection situation 💫
  • permit — Preallocated permit. you grab it before, you don't just spawn one mid-request 🎟️
  • vec — Message that is sent to server together with the request. Sum of len of all vec elements limited to <= IO_MSG_SIZE. Since the msg is copied internally it can be allocated on stack. stack-allocated is lowkey fine here, not me gatekeeping 🧺
  • nr — Number of elements in vec. count 'em 🔢
  • data_len — length of data sent to/from server 📏
  • sg — Pages to be sent/received to/from server. the actual payload pages bestie 🗂️
  • sg_cnt — Number of elements in the sg 🔢✨

🔥 RETURN 🔥

  • 0 — Success 🥳
  • <0 — Error 😭
fr fr, anything below zero is a no-go, check it before you celebrate 💀

👑 DESCRIPTION 👑

On dir=READ the rtrs client will request a data transfer from Server to client. The data that the server will respond with will be stored in sg when the user receives an RTRS_CLT_RDMA_EV_RDMA_REQUEST_WRITE_COMPL event. yes, that event name is a whole mouthful, we know, and yes, it's spelled exactly like that — don't @ me ⭐

On dir=WRITE the rtrs client will rdma write data in sg to server side. iconic behaviour honestly 💅🔥

🌈 SEE ALSO 🌈

Kernel file ./drivers/infiniband/ulp/rtrs/rtrs-clt.c — go read the source, bestie, it's giving main character energy 📖💖

okay that's the whole page, you ate that 🍓 this lil manpage lives in ./drivers/infiniband/ulp/rtrs, dated October 2026 — mwah, slay, periodt 💋🎀🦋

📦 where this page comes from