STRUCT PBN_LOCK_POOL(9)

💖 struct pbn_lock_pool(9) — the kernel API manual bestie 💖

okay so we're diving into struct pbn_lock_pool(9) today, from the Kernel API Manual, and honestly? it's giving "humble little data structure that carries the whole team." no cap. stay with me 🫶

---

✨ NAME ✨

struct pbn_lock_pool — literally just a list of PBN locks. that's the whole vibe. 💅

---

✨ SYNOPSIS ✨

struct pbn_lock_pool {
    size_t capacity;
    size_t borrowed;
    struct list_head idle_list;
    idle_pbn_lock locks[];
};

look at her. four fields. immaculate. 🌸

---

✨ Members ✨

• capacity — the number of locks that were allocated for the pool. like, how many seats are in the venue, bestie. 🎀
• borrowed — the number of locks that are currently borrowed from the pool. who's out on loan rn. 👀
• idle_list — a list containing all the idle PBN lock instances. the ones just chilling, not doing anything, living their best life. 🦋
• locks — the memory for all the locks this pool allocated. it's the actual storage, the whole point. 🔥

---

✨ Description ✨

okay so real talk: the lock pool is little more than the memory that's been allocated for the locks. that's it. that's the description. she's lowkey minimal and I respect it so much. 💀✨

---

✨ SEE ALSO ✨

bestie, this list is long and every single one of these matters, so let's go, no skipping, we're doing all of them: 🧚

the kernel file ./drivers/md/dm-vdo/physical-zone.c, plus:

• 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)
• 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_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)

go read them all, iykyk 👑

---

that's the whole page, bestie — every field, every cross-reference, nothing dropped. periodt. 💜

---

and that's a wrap on struct pbn_lock_pool(9) from the kernel's ./drivers/md/dm-vdo corner of the world, dated October 2026 — mwah, go touch some locks (responsibly) 🍓🌈⭐