ib_sa_path_rec_get(9)

💅 ib_sa_path_rec_get — the Kernel API Manual moment

okay so bestie, we're in the Kernel API Manual today and the function is ib_sa_path_rec_get(9) ✨

🌸 NAME 🌸

ib_sa_path_rec_get — start a Path get query 🦋 like, you're kicking off a whole quest to find a path, no big deal

✨ SYNOPSIS ✨

int ib_sa_path_rec_get (struct ib_sa_client *client , struct ib_device
*device , u32 port_num , struct sa_path_rec *rec , ib_sa_comp_mask
comp_mask , unsigned long timeout_ms , gfp_t gfp_mask , void
(*callback)(int status, struct sa_path_rec *resp, unsigned int
num_paths, void *context) , void *context , struct ib_sa_query
**sa_query );

like… that's a lot of parameters, but we love a thorough icon 💅

🎀 ARGUMENTS 🎀

• client — the SA client, your lil membership card to the whole operation 🫶
• device — which device we're sending the query on, bestie, pick one
• port_num — and the port number to send it on, obvi 🌈
• rec — the Path Record that actually goes inside the query, the main character of this whole thing 👑
• comp_mask — the component mask that goes in the query too
• timeout_ms — how long we're willing to wait for a response before we're like "okay this is taking forever 😭" (it's in ms, keep up)
• gfp_mask — the GFP mask used for internal allocations, lowkey important
• callback — the function that gets called when the query completes, times out, or is canceled ⭐
• context — an opaque user context that gets passed straight to the callback, like a little gift you hand forward 🎁
• sa_query — the query context, which is how you cancel the query later if you change your mind 🙈

💖 DESCRIPTION 💖

okay so what this does: it sends a Path Record Get query to the SA so it can look up a path 🔥

Then when the query completes (or fails, ngl it happens), your callback function gets called. And the status it hands you tells the whole story:

• 0 — slay, successful response 💚
• -EINTR — the query was canceled, fair enough
• -ETIMEDOUT — the query timed out, we waited and waited 😭
• -EIO — an error happened while sending the query, tragic 💀

⚠️ super important bestie: the resp parameter of the callback is only valid if status is 0. Like, do not touch it otherwise, I'm begging 🙏

And about the return value of ib_sa_path_rec_get itself:

• if it's negative, that's an error code, periodt 💀
• otherwise it's a query ID — and you keep that, because that's the thing you use to cancel the query later 🌟

🦋 SEE ALSO 🦋

• Kernel file ./drivers/infiniband/core/sa_query.c
• ib_sa_cancel_query(9) — the cancel-this-query bestie
• ib_init_ah_attr_from_path(9)
• ib_sa_service_rec_get(9)

---

and that's the vibe check on this one, bestie 🧚 this page came from the ./drivers/infiniband/core corner of the kernel, dated October 2026, and it's filed under ib_sa_path_rec_get(9) — iconic, no cap 💜🎀