vdo_get_phys...one_pbn_lock(9)

okay bestie, welcome to the Kernel API Manual page called vdo_get_phys...one_pbn_lock(9) — yes, the title is literally doing the ellipsis thing, and the actual function is vdo_get_physical_zone_pbn_lock. She's specific, she's iconic, and we're gonna get through every single detail together 💅✨

💖 NAME 💖

vdo_get_physical_zone_pbn_lock — get the lock on a PBN if one exists. That's the whole name-vibe: if there's a lock, you get it; if there isn't, you don't. Periodt.

✨ SYNOPSIS ✨

Here's the signature, bestie — copy it exactly, no freestyling:

struct pbn_lock * vdo_get_physical_zone_pbn_lock (struct physical_zone
       *zone , physical_block_number_t pbn );

🎀 ARGUMENTS 🎀

• zone — the physical zone responsible for the PBN. Like, the zone that's responsible for this block number, okay?
• pbn — the physical block number whose lock is desired. You want the lock for this pbn, and you're asking nicely.

🦋 RETURN 🦋

You get the lock, or NULL if the PBN is not locked. That's the whole return situation — lock if locked, NULL if not locked, no cap.

🌈 SEE ALSO 🌈

This all lives in the Kernel file ./drivers/md/dm-vdo/physical-zone.c, and here's the whole friend group — every single one, because we do not skip the 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)
• return_pbn_lock_to_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_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)

okay bye bestie 🫶 this page's footer says source/version ./drivers/md/dm-vdo, dated October 2026, with the footer title vdo_get_phys...one_pbn_lock(9) — slay and goodnight 💖👑