vdo_acquire...al_reference(9)

📦 version 7.3.1, in nixpkgs unstable

💅 vdo_acquire_provisional_reference — a Kernel API Manual moment 🎀

okay so bestie, welcome to the Kernel API Manual page for vdo_acquire_provisional_reference(9) — yes the header got a little chopped in the terminal title and we're just gonna roll with it ✨

🌸 NAME 🌸

vdo_acquire_provisional_reference — bestie, this one grabs you a provisional reference on behalf of a PBN lock, but ONLY if the block that lock is holding onto is literally unreferenced. no cap, that's the whole vibe 💅

✨ SYNOPSIS ✨

int vdo_acquire_provisional_reference (struct vdo_slab *slab ,
physical_block_number_t pbn , struct pbn_lock *lock );

like, that's the whole signature. int in, int out, three args in the middle 🫶

🦋 ARGUMENTS 🦋

  • slab — the slab that's holding the block. it's giving "the container of the thing" energy 💖
  • pbn — the physical block that wants a reference. the actual main character here 👑
  • lock — the lock. that's it. that's the description. short and iconic 🎀

💀 RETURN 💀

VDO_SUCCESS — or, y'know, an error 😭 (the manpage itself keeps it mysterious, and honestly? respect.)

🌈 SEE ALSO 🌈

okay so this is the part where the page absolutely ATE — literally the entire slab-depot friend group got invited 🫶. Kernel file: ./drivers/md/dm-vdo/slab-depot.c, and these icons:

like, all of them. every single one. we don't skip ✨

and that's the page bestie!! 🧚 source: ./drivers/md/dm-vdo, dated October 2026 — so like, future-coded of it 💜 go forth and acquire those provisional references, iykyk 🦋⭐🔥

📦 where this page comes from