rdma_find_gid(9)

💖 rdma_find_gid(9) — Kernel API Manual 💖

okay bestie, welcome to the rdma_find_gid(9) page from the Kernel API Manual. This one is a little GID-lookup situation, and we’re gonna read it together. 💅

✨ NAME ✨

rdma_find_gid — returns SGID attributes if the matching GID is found. That’s the whole mission. 🎀

🌸 SYNOPSIS 🌸

const struct ib_gid_attr * rdma_find_gid (struct ib_device *device ,
const union ib_gid *gid , enum ib_gid_type gid_type , struct net_device
*ndev );

🦋 ARGUMENTS 🦋

• device — the device to query. Like, which RDMA device are we asking? 👀
• gid — the GID value to search for. The actual thing we’re hunting.
• gid_type — the GID type to search for. Gotta match the type too, no cap.
• ndev — in RoCE, the net device of the device. NULL means ignore. So if it’s NULL, we’re not checking that.

💜 DESCRIPTION 💜

rdma_find_gid searches for the specified GID value in the software cache. It’s giving “look it up in the cache, bestie” energy. ✨

It returns GID attributes if a valid GID is found, or returns ERR_PTR for the error. The caller must invoke rdma_put_gid_attr to release the reference. Do not forget this part — not me being dramatic, it’s literally the cleanup rule. 🫶

lowkey important: the caller has to call rdma_put_gid_attr to release the reference.

🌈 SEE ALSO 🌈

• Kernel file ./drivers/infiniband/core/cache.c
• free_gid_work(9)
• del_gid(9)
• add_modify_gid(9)
• rdma_find_gid_by_port(9)
• rdma_find_gid_by_filter(9)
• rdma_query_gid(9)
• rdma_read_gid_hw_context(9)
• rdma_get_gid_attr(9)
• rdma_query_gid_table(9)
• rdma_put_gid_attr(9)
• rdma_hold_gid_attr(9)
• rdma_read_gid_attr_ndev_rcu(9)
• rdma_read_gid_l2_fields(9)
• ib_dispatch_event(9)

okay that’s the page, bestie. This one’s from source/version ./drivers/infiniband/core, dated October 2026, and its title is rdma_find_gid(9). byeee, go release your references 💖🎀✨