initialize_zone(9)

💫 initialize_zone — bestie's guide to the kernel API 💫

okay so real talk, this is initialize_zone(9) from the Kernel API Manual, and honestly? it's giving "tiny function, big friend group." she's a little one, but she's connected, iykyk ✨

---

🌸 NAME 🌸

initialize_zone — Initialize a physical zone. periodt, that's the whole job 🫶

---

🎀 SYNOPSIS 🎀

int initialize_zone (struct vdo *vdo , struct physical_zones *zones );

like, that's her whole signature, no cap. int in, int out, two pointers and a dream 💅

---

🦋 ARGUMENTS 🦋

• vdo — The vdo to which the zone will belong. so like, this is the family she's marrying into 🏠💖
• zones — The physical_zones to which the zone being initialized belongs. yes bestie, the zone belongs to the zones. that's not a typo, that's just how it is 😭

---

⭐ RETURN ⭐

VDO_SUCCESS or an error code. that's it. slay or fail, no in-between 👑

---

🌈 SEE ALSO 🌈

okay this is the part where the friend group gets huge, so buckle up 🧚

Kernel file ./drivers/md/dm-vdo/physical-zone.c, and then literally the whole extended universe:

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

like, she knows everyone. main character energy fr fr 💀🔥

---

ngl bestie, if you only remember one thing: vdo + zones in, VDO_SUCCESS or an error out, and the whole pbn-lock clique is one SEE ALSO away 🫶

---

and that's the page!! sourced straight from ./drivers/md/dm-vdo, dated October 2026, filed under initialize_zone(9) — mwah, go read the real docs too, ily 💜🎀✨