rvt_alloc_lkey(9)

📦 version 7.3.1, in nixpkgs unstable

💅 rvt_alloc_lkey — allocate an lkey ✨

okay so bestie, welcome to the kernel API manual (that's the section 9 energy, we love her), and today's main character is rvt_alloc_lkey. she's a little function with a big job and honestly? she ate. 🎀

✨ NAME ✨

rvt_alloc_lkey — allocate an lkey 🦋

like, literally, she allocates an lkey. that's the whole vibe. no cap.

🌸 SYNOPSIS 🌸

int rvt_alloc_lkey (struct rvt_mregion *mr , int dma_region );

so she takes two lil friends and hands you back an int. that's it, that's the signature. copy it exactly, don't be cute with it 🔥

🎀 ARGUMENTS 🎀

  • mr — the memory region that this lkey protects 🛡️ like, the lkey is her bodyguard, ok? this is who she's guarding.
  • dma_region — a little switch, and the values matter: 0 → normal key, 1 → restricted DMA key. two moods, both iconic 💅

🧚 DESCRIPTION 🧚

so here's the tea, bestie:

returns 0 if successful, otherwise returns -errno. classic kernel behavior — zero means slay, negative means 😭.

she increments the mr reference count as required. yes, refcounting. yes, she's being responsible. we love a lowkey responsible queen 👑

and she sets the lkey field mr for non-dma regions. note it: non-dma regions only. don't come for her about the rest 🙈

fr fr, this is one of those functions where the entire description is three lines — so don't go inventing extra behavior, she doesn't need you to write her fanfic. 💀

🌈 SEE ALSO 🌈

okay this is the group chat of related functions and i need you to know ALL of them, because the manpage said so and we do not skip parts in this house 🫶

the kernel file they live in is ./drivers/infiniband/sw/rdmavt/mr.c, and the whole squad is:

nineteen besties. count 'em. iykyk ⭐

and that's the page, bestie — brought to you by the rvt_alloc_lkey(9) corner of the Kernel API Manual, sourced from ./drivers/infiniband/sw/rdmavt, dated October 2026. mwah, go allocate something 💖✨

📦 where this page comes from