vdo_start_draining(9)

✨ NAME ✨

okay so bestie, this is vdo_start_draining(9) from the Kernel API Manual — and it's literally the function that initiates a drain operation if the current state permits it. no cap, the state has to say yes first 💅

🌸 SYNOPSIS 🌸

bool vdo_start_draining (struct admin_state *state , const struct
       admin_state_code *operation , struct vdo_completion *waiter ,
       vdo_admin_initiator_fn initiator );

🎀 ARGUMENTS 🎀

• state — the current admin state. this is the vibe check for whether the drain can even start.
• operation — the type of drain to initiate. pick your drain era, bestie.
• waiter — the completion to notify when the drain is complete. it's the bestie who gets the “we're done” ping 🫶
• initiator — the vdo_admin_initiator_fn to call if the operation may begin; may be NULL. yes, it can be NULL, so don't panic.

🔥 RETURN 🔥

true if the drain was initiated; if not, the waiter will be notified. that's the return tea, and that's the whole sentence ☕

🌈 SEE ALSO 🌈

Kernel file ./drivers/md/dm-vdo/admin-state.c, plus the whole linked-up crew:

• get_next_state(9)
• vdo_finish_operation(9)
• begin_operation(9)
• start_operation(9)
• check_code(9)
• assert_vdo_drain_operation(9)
• vdo_finish_draining(9)
• vdo_finish_draining_with_result(9)
• vdo_assert_load_operation(9)
• vdo_start_loading(9)
• vdo_finish_loading(9)
• vdo_finish_loading_with_result(9)
• assert_vdo_resume_operation(9)
• vdo_start_resuming(9)
• vdo_finish_resuming(9)
• vdo_finish_resuming_with_result(9)
• vdo_resume_if_quiescent(9)
• vdo_start_operation(9)
• vdo_start_operation_with_waiter(9)

mwah 💋 source/version: ./drivers/md/dm-vdo; date: October 2026 — go be iconic in the kernel, bestie 🫶