return_pbn_lock_to_pool(9)

💅 return_pbn_lock_to_pool(9) 💅

okay so welcome to the Kernel API Manual page for return_pbn_lock_to_pool(9) — yes bestie, we're in the kernel docs and this one is giving "last one out, turn off the lights" energy ✨

✨ NAME ✨

return_pbn_lock_to_pool — Return a pbn lock to its pool. 💖

🦋 SYNOPSIS 🦋

void return_pbn_lock_to_pool (struct pbn_lock_pool *pool , struct pbn_lock *lock );

that's the whole function signature, no cap. 🫶

🎀 ARGUMENTS 🎀

• pool — The pool from which the lock was borrowed.
• lock — The last reference to the lock being returned.

two args, both main characters. 💅

💖 DESCRIPTION 💖

okay so the tea ☕: this returns a pbn lock to its pool. It must be the last live reference, as if the memory were being freed. the lock memory will be re-initialized or zeroed. 😭

⚠️ vibe check / warning: it has to be the last live reference, like the memory is literally being freed — the lock memory will be re-initialized or zeroed. do not play with this, bestie. 💀

🌈 SEE ALSO 🌈

the kernel file ./drivers/md/dm-vdo/physical-zone.c is lowkey the hub for all this, and here's the whole squad:

• vdo_is_pbn_read_lock(9)
• vdo_downgrade_pbn_write_lock(9)
• vdo_claim_pbn_lock_increment(9)
• vdo_assign_pbn_lock_provisional_reference(9)
• vdo_unassign_pbn_lock_provisional_reference(9)
• release_pbn_lock_provisional_reference(9)
• union idle_pbn_lock(9)
• struct pbn_lock_pool(9)
• make_pbn_lock_pool(9)
• free_pbn_lock_pool(9)
• borrow_pbn_lock_from_pool(9)
• initialize_zone(9)
• vdo_make_physical_zones(9)
• vdo_free_physical_zones(9)
• vdo_get_physical_zone_pbn_lock(9)
• vdo_attempt_physical_zone_pbn_lock(9)
• allocate_and_lock_block(9)
• retry_allocation(9)
• continue_allocating(9)
• vdo_allocate_block_in_zone(9)
• vdo_release_physical_zone_pbn_lock(9)
• vdo_dump_physical_zone(9)

xoxo bestie 💖 source/version: ./drivers/md/dm-vdo · date: October 2026 🌸🫶✨