cma_ib_acquire_dev(9)

📦 version 7.3.1, in nixpkgs unstable

💅 cma_ib_acquire_dev(9) — like, the kernel API manual bestie 🎀

okay so we're in the Kernel API Manual today and the star of the show is cma_ib_acquire_dev(9). yes that's a mouthful, no i will not be shortening it, it's iconic and it knows it ✨

🌸 NAME 🌸

cma_ib_acquire_dev — acquire cma device, port and SGID attribute 🫶

like literally that's the whole vibe. it goes and gets the device, the port, and the SGID attribute. main character energy fr fr.

🦋 SYNOPSIS 🦋

int cma_ib_acquire_dev (struct rdma_id_private *id_priv , const struct
       rdma_id_private *listen_id_priv , struct cma_req_info *req );

returns an int, takes three args. slay. no cap, that's it 💅

⭐ ARGUMENTS ⭐

  • id_priv — the cm id you're binding to the cma device. yeah that one. that's your girl 👑
  • listen_id_priv — the listener cm id that gets matched against. it's the one doing the matching, iykyk 🌈
  • req — pointer to the req structure containing the incoming request info. it's literally carrying the info, let it cook 🍓

💖 what it actually does 💖

okay so here's the tea ☕ — cma_ib_acquire_dev acquires the cma device, the port and the SGID attribute when the rdma device matches the listen_id and the incoming request. both. it's picky and honestly? valid 🙈

it also verifies that a GID table entry is present for the source address — like a little bouncer at the club checking the list 🧚

returns 0 on success, or returns an error code otherwise. bestie if you get a non-zero back, something went sideways, no cap 💀

🔥 SEE ALSO 🔥

kernel file ./drivers/infiniband/core/cma.c — go read it, it's giving lore ✨

and the whole friend group:

all of them. every single one. we don't do skipping here 🫶

🎀 cute lil sign-off 🎀 this page lives in ./drivers/infiniband/core and it's dated October 2026 — yes, from the future, obsessed. mwah, go acquire some devices bestie 💜🦋🌸
📦 where this page comes from