move_empty_bucket(9)

💅 move_empty_bucket(9) — the Kernel API Manual, but make it cute

okay bestie, so this is a page from the Kernel API Manual — move_empty_bucket(9) — and honestly? it's giving "tiny function, big job." let's get into it 🎀

---

✨ NAME ✨

move_empty_bucket — literally just moves an empty bucket closer to the start of the bucket array. that's it. that's the whole vibe. 🌸

---

🦋 SYNOPSIS 🦋

struct bucket * move_empty_bucket (struct bucket *hole );

copy it exactly bestie, spacing and all, no cap 💅

---

💖 ARGUMENTS 💖

• hole — the empty bucket that we wanna fill up with an entry that precedes it in one of its enclosing neighborhoods 👑 that's the whole assignment. she's empty, she's waiting, she's the main character.

---

🌈 DESCRIPTION 🌈

so here's the tea: this function searches the neighborhoods that contain the empty bucket, looking for a non-empty bucket that sits closer to the start of the array. 🔍✨

if such a bucket is found, this swaps the two buckets by moving the entry into the empty bucket. lowkey elegant, highkey iconic. 🫶

---

⭐ RETURN ⭐

it returns the bucket that was vacated by moving its entry to the provided hole 💀

or NULL if no entry could be moved. that's it, that's the answer, no notes. 🙈

---

ok so quick vibe check: no entry moved = NULL back atcha. don't come for her, she told you upfront. 😭

---

🍓 SEE ALSO 🍓

• Kernel file ./drivers/md/dm-vdo/int-map.c
• Introduction(9)
• struct bucket(9)
• struct int_map(9)
• mix(9)
• hash_key(9)
• allocate_buckets(9)
• vdo_int_map_create(9)
• vdo_int_map_free(9)
• vdo_int_map_size(9)
• dereference_hop(9)
• insert_in_hop_list(9)
• select_bucket(9)
• search_hop_list(9)
• vdo_int_map_get(9)
• resize_buckets(9)
• find_empty_bucket(9)
• update_mapping(9)
• find_or_make_vacancy(9)
• vdo_int_map_put(9)
• vdo_int_map_remove(9)

like, the whole friend group showed up for this one 😭💜 go read them too, iykyk.

---

and that's the page!! 💖✨ this little icon lives in ./drivers/md/dm-vdo and the version/date on the tin says October 2026 — so go forth, move those empty buckets, and slay 🎀🦋👑 periodt.