STRUCT SRPT_DEVICE(9)

💅 struct srpt_device(9) — like, the whole kernel API manual but make it make sense

okay so bestie, welcome to the struct srpt_device(9) glow-up ✨ this is the kernel API manual page for struct srpt_device, and we're about to get into it. no cap, it's giving "one struct to hold all the HCA info" and honestly? iconic.

---

🌸 NAME 🌸

struct srpt_device — the info that SRPT keeps around for a single HCA 💖 (yes, one whole HCA. main character energy fr fr)

---

🦋 SYNOPSIS 🦋

like, here's the literal struct, copy-paste it exactly, do not come for me:

struct srpt_device {
    struct kref             refcnt;
    struct ib_device        *device;
    struct ib_pd            *pd;
    u32 lkey;
    struct ib_srq           *srq;
    struct ib_cm_id         *cm_id;
    int srq_size;
    struct mutex            sdev_mutex;
    bool use_srq;
    struct kmem_cache       *req_buf_cache;
    struct srpt_recv_ioctx  **ioctx_ring;
    struct ib_event_handler event_handler;
    struct list_head        list;
    struct srpt_port        port[];
};

---

🎀 Members 🎀

okay now the vibe check on every single field, no skipping, we don't do that here 🫶

• refcnt — the reference count for this device. it's literally counting refs, that's the whole job 💅
• device — a backpointer to the struct ib_device that the IB core manages 👑
• pd — the IB protection domain 🛡️
• lkey — the L_Key (local key) that has write access to, like, all local memory 🔥 big permissions energy.
• srq — the per-HCA SRQ, aka the shared receive queue 🌈
• cm_id — the connection identifier ✨
• srq_size — the SRQ size, which is... the size of the SRQ 🙈
• sdev_mutex — serializes use_srq changes 🔒 so like, one at a time please.
• use_srq — whether or not to use SRQ. a simple yes/no king 👑
• req_buf_cache — the kmem_cache for ioctx_ring buffers 🧺 caching, but make it buffers.
• ioctx_ring — per-HCA SRQ. (yes, same description as srq, I don't make the rules, I just report them 💀)
• event_handler — the per-HCA asynchronous IB event handler 🦋 catching events, staying booked and busy.
• list — the node in srpt_dev_list 🔗 linked-list realness.
• port — info about the ports owned by this HCA ⚓ (it's an array, port[], noted 🎀)

---

⭐ SEE ALSO ⭐

go read these next, bestie, it's a whole universe:

• Kernel file ./drivers/infiniband/ulp/srpt/ib_srpt.h enum
• srpt_command_state(9)
• struct srpt_ioctx(9)
• struct srpt_recv_ioctx(9)
• struct srpt_send_ioctx(9)
• enum rdma_ch_state(9)
• struct srpt_rdma_ch(9)
• struct srpt_nexus(9)
• struct srpt_port_attrib(9)
• struct srpt_tpg(9)
• struct srpt_port_id(9)
• struct srpt_port(9)

---

💖 cute lil sign-off: this page lives in ./drivers/infiniband/ulp/srpt, dated October 2026, and yeah it's still struct srpt_device(9) at the bottom, periodt. 🎀✨