rdma_restrack_sync(9)

✨ rdma_restrack_sync(9) ✨

okay bestie, welcome to the Kernel API Manual</> 💅 this one's a lil kernel function called rdma_restrack_sync, and honestly it's giving barrier realness</> — let's get into it 🫶

---

🌸 NAME 🌸

rdma_restrack_sync — fence concurrent netlink dumps on an entry 🔥

---

🦋 SYNOPSIS 🦋

void rdma_restrack_sync (struct rdma_restrack_entry *res );

---

🎀 ARGUMENTS 🎀

• res — the resource entry, bestie. that's the whole vibe. 👑

---

💖 DESCRIPTION 💖

so here's the tea ☕ — once this function returns, any concurrent netlink dump threads will see the current value</> of the object. no cap, they're synced up. ✨

this is useful if the object has to be changed and there is not locking</> to protect the nl side. eg for mr->pd. iykyk 😌

the way it works is genuinely iconic: it effectively destroys the object from a kref/xarray perspective</> and then immediately restores it</>. the kref is acting like a lock to barrier concurrent nl threads. slay. 🔒

⚠️ okay this part matters, don't skip it: callers must ensure rdma_restrack_del is not concurrently called. fr fr, do not do that. 💀

---

🧚 SEE ALSO 🧚

kernel file ./drivers/infiniband/core/restrack.c — and the whole restrack bestie squad 💜:

• rdma_restrack_init(9)
• rdma_restrack_clean(9)
• rdma_restrack_count(9)
• rdma_restrack_attach_task(9)
• rdma_restrack_set_name(9)
• rdma_restrack_parent_name(9)
• rdma_restrack_new(9)
• rdma_restrack_add(9)
• rdma_restrack_abort_del(9)
• rdma_restrack_get_byid(9)
• rdma_restrack_del(9)
• rdma_restrack_begin_del(9)
• rdma_restrack_commit_del(9)

---

and that's the whole page, bestie 🌈💅 this lil gem lives in ./drivers/infiniband/core, dated October 2026</> — go forth and fence those netlink dumps, you absolute main character 🎀✨🦋