srpt_lookup_port(9)

📦 version 7.3.1, in nixpkgs unstable

💅 srpt_lookup_port — the kernel API manual, but make it cute

okay so bestie, welcome to srpt_lookup_port(9) from the Kernel API Manual ✨ this one's a tiny little function and honestly it's giving "small but mighty" — so let's get into it 🎀

🌸 NAME 🌸

srpt_lookup_port — literally just look up an RDMA port by its name 🔍✨

🦋 SYNOPSIS 🦋

struct port_and_port_id srpt_lookup_port (const char *name );

that's it. that's the whole signature. she's compact 💅 note that the name parameter is a const char *, and the whole thing hands you back a struct port_and_port_id — no cap 🫶

🎀 ARGUMENTS 🎀

  • name — the ASCII port name, aka the little string you're using to find your port 🌈 keep it ASCII, bestie, that's the vibe 💖

👑 DESCRIPTION 👑

so here's the thing you actually need to remember, and this is the important part so pay attention 🙈

if an RDMA port pointer comes back to you, this function increments the RDMA port reference count 🔥 which means you're now holding a reference, which means you are responsible for it. the caller (that's you, bestie 💅) must drop that reference count by calling srpt_port_put_ref.

⚠️ hello?? do not forget the srpt_port_put_ref!! you got a ref, you gotta put the ref back. that's the whole deal. leaking refs is not the main character energy we're going for 😭

💜 SEE ALSO 💜

the whole friend group 🫶 these are the siblings, cousins, and distant relatives — every single one, no skips:

and that's the page, bestie 🥰 before you go — this iconic little doc lives in ./drivers/infiniband/ulp/srpt and it's dated October 2026 🗓️✨ slay, go drop your ref counts, and i'll see you in the next manpage 💖🦋💅

📦 where this page comes from