hfi1_rcd_get_by_index_safe(9)

hiii bestie 💖 welcome to the hfi1_rcd_get_by_index_safe(9) page from the Kernel API Manual. This one is short and sweet: it’s the safe little vibe-check wrapper that validates the ctxt index before the code goes poking at the array ✨

🎀 NAME 🎀

hfi1_rcd_get_by_index_safe — validate the ctxt index before accessing the array 💅

🌸 SYNOPSIS 🌸

struct hfi1_ctxtdata * hfi1_rcd_get_by_index_safe (struct hfi1_devdata
*dd , u16 ctxt );

💅 ARGUMENTS 💅

• dd — pointer to a valid devdata structure. Valid is the whole point, bestie 🫶
• ctxt — the index of an possilbe rcd. And yes, possilbe is literally the spelling on the page — keeping it 100% as-is 😭

🦋 DESCRIPTION 🦋

This is a wrapper for hfi1_rcd_get_by_index to validate that the given ctxt index is valid. It’s giving “look before you leap” in kernel form — no touching the array until that index has passed the vibe check 💅✨

The caller is responsible for making the _put. Periodt. Don’t forget the _put, bestie — that’s the rule 👑

👑 SEE ALSO 👑

Kernel file ./drivers/infiniband/hw/hfi1/init.c is where the whole friend group lives. Go say hi to:

• hfi1_rcd_free(9)
• hfi1_rcd_put(9)
• hfi1_rcd_get(9)
• allocate_rcd_index(9)
• hfi1_rcd_get_by_index(9)
• hfi1_free_ctxt(9)
• init_after_reset(9)
• create_workqueues(9)
• destroy_workqueues(9)
• enable_general_intr(9)
• hfi1_init(9)
• shutdown_device(9)
• hfi1_free_ctxtdata(9)
• hfi1_free_devdata(9)
• hfi1_alloc_devdata(9)
• hfi1_create_rcvhdrq(9)
• hfi1_setup_eagerbufs(9)

mwah 💋 — signed off from source/version ./drivers/infiniband/hw/hfi1 / Kernel API Manual, dated October 2026. That’s the whole page, bestie — go validate those indexes responsibly 🫶🌈